Skip to main content

Documentation Index

Fetch the complete documentation index at: https://www.truefoundry.com/llms.txt

Use this file to discover all available pages before exploring further.

A2AFramework

type
typing.Literal[Any]
default:"a2a"
required
Type
agent_card_path
str
default:"/.well-known/agent-card.json"
required
Path to the agent card JSON, relative to the base URL

Account

id
typing.Optional[str]
tenant_name
typing_extensions.Annotated[(str, Any, Any)]
required
fqn
str
required
manifest
typing.Dict[(str, typing.Any)]
required
Account manifest
created_by_subject
typing_extensions.Annotated[(Subject, Any, Any)]
required
created_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any, Any)]
updated_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any, Any)]
is_editable
typing_extensions.Annotated[(bool, Any, Any)]
required

AccountInfo

account_id
typing_extensions.Annotated[(str, Any, Any)]
required
name
str
required

ActivateUserResponse

Union, One Of:

AddonComponent

name
AddonComponentName
required
app_name
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
namespace
typing.Optional[str]
application_id
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
description
typing.Optional[str]
path
typing.Optional[str]
addon_folder
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
installed
typing.Optional[bool]
status
typing.Optional[AddonComponentStatus]
version
typing.Optional[str]
manifest
typing.Optional[typing.Dict[(str, typing.Any)]]
installation_source
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
unsupported_cluster_types
typing_extensions.Annotated[(typing.Optional[typing.List[ClusterType]], Any, Any)]
required
typing.Optional[bool]
known_cr_ds
typing_extensions.Annotated[(typing.Optional[typing.List[str]], Any, 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, Any)]
metadata
typing.Optional[typing.Dict[(str, typing.Any)]]
Addon metadata. autopilotEnabled is true when the backing addon application has autopilot enabled; otherwise false.

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, Any)]
sync_status
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
installed
bool
required
Indicates whether the addon is installed

AgentFramework

Union, One Of:

AgentManifest

Union, One Of:

AgentSkill

id
str
required
name
str
required
description
str
required
tags
typing.Optional[typing.List[str]]
examples
typing.Optional[typing.List[str]]
input_modes
typing_extensions.Annotated[(typing.Optional[typing.List[str]], Any, Any)]
output_modes
typing_extensions.Annotated[(typing.Optional[typing.List[str]], Any, Any)]

AgentSkillManifest

name
str
required
Name of the skill.
metadata
typing.Dict[(str, typing.Any)]
required
Key value metadata. Should be valid JSON. For e.g. \{"business-unit": "sales", "quality": "good", "rating": 4.5\}
ml_repo
str
required
Name of the ML Repo
version
typing.Optional[int]
Version of the entity
type
typing.Literal[Any]
default:"agent-skill"
required
source
AgentSkillManifestSource
required

AgentSkillManifestSource

Union, One Of:

AgentSkillSourceBlobStorage

type
typing.Literal[Any]
default:"blob-storage"
required
description
str
required
1–1024 chars.
uri
str
required
Storage URI of the blob storage object where the skill is stored.

AgentSkillSourceInline

type
typing.Literal[Any]
default:"inline"
required
skill_md
str
required
Main body of SKILL.md file.

AgentSkillSourceLocal

type
typing.Literal[Any]
default:"local"
required
skill_dir
str
required
Path to the skill root directory, including SKILL.md and related assets.

AgentSkillVersion

id
str
required
Unique identifier for the artifact version
fqn
str
required
Fully qualified name of the artifact version in the format β€˜{artifact_type}:{tenant_name}/{ml_repo_name}/{artifact_name}:{version}’
created_by_subject
Subject
required
πŸ”— SubjectSubject (user, team, or service account) that created this artifact version
created_at
typing.Optional[dt.datetime]
Timestamp when the artifact version was created
updated_at
typing.Optional[dt.datetime]
Timestamp when the artifact version was last updated
manifest
AgentSkillManifest
required
πŸ”— AgentSkillManifestManifest containing metadata specific to this agent skill version
ml_repo_id
str
required
ID of the ML Repo that this artifact version belongs to
agent_skill_id
str
required
ID of the parent agent skill artifact that this version belongs to

AgentSource

Union, One Of:

Ai21KeyAuth

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

Ai21Model

type
typing.Literal[Any]
default:"integration/model/ai21"
required
name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The AI21 model identifier (e.g., jamba-large, jamba-mini). This is the model name from AI21’s model catalog.
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
The name of the AI21 provider account
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
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

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.

AktoGuardrailConfig

name
str
required
The name of the Guardrail Config.
description
typing.Optional[str]
Optional description for this Guardrail Config.
type
typing.Literal[Any]
default:"integration/guardrail-config/akto"
required
auth_data
AktoTokenAuth
required
operation
typing.Literal[Any]
default:"validate"
required
The operation type for this guardrail. Akto guardrails can only be used for validation.
enforcing_strategy
EnforcingStrategy
required
config
AktoGuardrailConfigConfig
required

AktoGuardrailConfigConfig

base_url
str
required
The base URL of the Akto guardrails service (e.g. https://your-akto-host:port)

AktoTokenAuth

type
typing.Literal[Any]
default:"token"
required
token
str
required
JWT token for authenticating with the Akto guardrails service

Alert

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

AlertConfig

type
typing.Literal[Any]
default:"alert-config"
required
Type
name
str
required
Name - 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.

AllDataAccessRule

scope
typing.Literal[Any]
default:"all_data"
required
Data access scope - access to all data with optional filters
filters
typing.Optional[typing.List[AllDataAccessRuleFiltersItem]]
πŸ”— AllDataAccessRuleFiltersItemOptional filters to restrict data access (only applicable for all_data scope)

AllDataAccessRuleFiltersItem

Union, One Of:

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
The API key for Anthropic authentication

AnthropicModel

name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The Anthropic model identifier (e.g., claude-3-5-sonnet-20241022, claude-3-opus-20240229, claude-3-haiku-20240307). This is the standard model name from Anthropic’s API documentation.
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
The name of the Anthropic provider account
auth_data
typing.Optional[AnthropicKeyAuth]
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
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

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, Any)]
required
tenant_name
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
metadata
typing.Optional[ApplicationMetadata]
lifecycle_stage
typing_extensions.Annotated[(ApplicationLifecycleStage, Any, Any)]
required
workspace_id
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
last_version
typing_extensions.Annotated[(typing.Optional[int], Any, Any)]
active_version
typing_extensions.Annotated[(typing.Optional[int], Any, Any)]
created_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any, Any)]
updated_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any, 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.Any)]], Any, Any)]
application_debug_infos
typing_extensions.Annotated[(typing.Optional[typing.List[Any]], Any, Any)]
potential_problems
typing_extensions.Annotated[(typing.Optional[typing.List[ApplicationProblem]], Any, Any)]
autopilot
typing.Dict[(str, typing.Any)]
required
workspace_fqn
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
created_by
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
deployment
typing.Optional[Any]
active_deployment_id
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
last_deployment_id
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]

ApplicationDebugInfo

id
typing.Optional[str]
application_id
typing_extensions.Annotated[(str, Any, Any)]
required
application
typing.Optional[Any]
debug_info
typing_extensions.Annotated[(typing.Dict[(str, typing.Any)], Any, Any)]
required
created_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any, Any)]
updated_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any, 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.Any)]]
Values to be used to render components for the application set.
workspace_fqn
typing.Optional[str]
Fully qualified name of the workspace
convert_template_manifest
typing.Optional[bool]
Flag to indicate if the template manifest should be converted to TrueFoundry manifest

ApplicationSetComponentsItem

Union, One Of:

ApplyMlEntityResponse

data
ApplyMlEntityResponseData
required
πŸ”— ApplyMlEntityResponseDataThe created or updated ML entity (model version, prompt version, agent skill version, artifact version, or data directory)

ApplyMlEntityResponseData

Union, One Of:

Artifact

id
str
required
Unique identifier for the artifact
ml_repo_id
str
required
ID of the ML Repo that this artifact belongs to
type
ArtifactType
required
πŸ”— ArtifactTypeType of the artifact (e.g., β€˜artifact’, β€˜model’, β€˜chat_prompt’, β€˜agent-skill’, β€˜plot’, β€˜image’)
name
str
required
Name of the artifact (alphanumeric characters, hyphens, and underscores only, max 256 characters)
fqn
str
required
Fully qualified name of the artifact in the format β€˜{artifact_type}:{tenant_name}/{ml_repo_name}/{artifact_name}’
created_by_subject
Subject
required
πŸ”— SubjectSubject (user, team, or service account) that created this artifact
created_at
typing.Optional[dt.datetime]
Timestamp when the artifact was created
updated_at
typing.Optional[dt.datetime]
Timestamp when the artifact was last updated
latest_version
typing.Optional[BaseArtifactVersion]
πŸ”— BaseArtifactVersionThe most recent version of this artifact
run_steps
typing.Optional[typing.List[int]]
List of run step numbers where this artifact was created or updated

ArtifactManifest

name
str
required
Name of the artifact (alphanumeric characters, hyphens, and underscores only, max 256 characters)
metadata
typing.Dict[(str, typing.Any)]
required
Key value metadata. Should be valid JSON. For e.g. \{"business-unit": "sales", "quality": "good", "rating": 4.5\}
ml_repo
str
required
Name of the ML Repo that this artifact belongs to (must start and end with alphanumeric, 2-100 characters)
version
typing.Optional[int]
Version of the entity
type
typing.Literal[Any]
default:"artifact-version"
required
description
typing.Optional[str]
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)
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
Unique identifier for the artifact version
fqn
str
required
Fully qualified name of the artifact version in the format β€˜{artifact_type}:{tenant_name}/{ml_repo_name}/{artifact_name}:{version}’
created_by_subject
Subject
required
πŸ”— SubjectSubject (user, team, or service account) that created this artifact version
created_at
typing.Optional[dt.datetime]
Timestamp when the artifact version was created
updated_at
typing.Optional[dt.datetime]
Timestamp when the artifact version was last updated
manifest
ArtifactManifest
required
πŸ”— ArtifactManifestManifest containing metadata for a generic artifact version
ml_repo_id
str
required
ID of the ML Repo that this artifact version belongs to
tags
typing.Optional[typing.List[str]]
List of tags associated with this artifact version for filtering and organization
version_alias
typing.Optional[str]
Optional human-readable version alias (e.g. v1.0.0)
usage_code_snippet
typing.Optional[str]
Code snippet demonstrating how to use this artifact version
artifact_id
str
required
ID of the parent artifact that this version belongs to

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:

AssistantMessageContentOneItem

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.Literal[Any]
default:"async-service"
required
replicas
AsyncServiceReplicas
required
πŸ”— AsyncServiceReplicasDeploy multiple instances of your pods to distribute incoming traffic across them, ensuring effective load balancing.
rollout_strategy
typing.Optional[Rolling]
worker_config
WorkerConfig
required
sidecar
typing.Optional[AsyncProcessorSidecar]

AsyncServiceAutoscaling

metrics
AsyncServiceAutoscalingMetrics
required
πŸ”— AsyncServiceAutoscalingMetricsMetrics to use for the autoscaler

AsyncServiceAutoscalingMetrics

Union, One Of:

AsyncServiceReplicas

Union, One Of:

AutoRotate

auto_rotate_interval
int
default:"360"
required
Rotation Interval in days after which the token will be rotated. Minimum value is 30.
grace_period
int
default:"30"
required
Grace Period in days for which the token will be valid after rotation interval. Minimum value is 1.

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.

AwsBedrockApiKeyAuth

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

AwsBedrockAssumedRoleBasedAuth

external_id
typing.Optional[str]
Optional external ID to use when assuming the role. This provides an added layer of security by ensuring only parties with the correct external ID can assume the role.

AwsBedrockGuardrailConfig

name
str
required
The name of the Guardrail Config.
description
typing.Optional[str]
Optional description for this Guardrail Config.
type
typing.Literal[Any]
default:"integration/guardrail-config/aws-bedrock"
required
auth_data
typing.Optional[AwsBedrockGuardrailConfigAuthData]
πŸ”— AwsBedrockGuardrailConfigAuthDataAuthentication data for the AWS account
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.
priority
typing.Optional[int]
default:"1"
Execution order for mutate guardrails. Lower values run first. Only applicable when operation is mutate.
enforcing_strategy
EnforcingStrategy
required
config
AwsBedrockGuardrailConfigConfig
required

AwsBedrockGuardrailConfigAuthData

Union, One Of:

AwsBedrockGuardrailConfigConfig

guardrail_id
str
required
The unique identifier of the Bedrock Guardrail created in AWS console
guardrail_version
str
required
Version number of the guardrail to use (e.g., 2 for version 2)
region
AwsRegion
required

AwsBedrockProviderAccount

type
typing.Literal[Any]
default:"provider-account/aws-bedrock"
required
name
str
required
The name of the AWS Bedrock provider account
region
AwsRegion
required
auth_data
typing.Optional[AwsBedrockProviderAccountAuthData]
πŸ”— AwsBedrockProviderAccountAuthDataAuthentication data for the AWS account
integrations
typing.List[BedrockModel]
required
πŸ”— BedrockModelList 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
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

AwsBedrockProviderAccountAuthData

Union, One Of:

AwsEcr

type
typing.Literal[Any]
default:"integration/docker-registry/aws/ecr"
required
name
str
required
The name of the integration that will be displayed in the TrueFoundry UI.
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
The name of the integration that will be displayed in the TrueFoundry UI.
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
The name of the integration that will be displayed in the TrueFoundry UI.
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>.
kms_arn
typing.Optional[str]
The ARN of the KMS key to use for encryption.

AwsParameterStoreAuthData

Union, One Of:

AwsProviderAccount

type
typing.Literal[Any]
default:"provider-account/aws"
required
name
str
required
The name of the AWS provider account.
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.
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

AwsProviderAccountAuthData

Union, One Of:

AwsS3

type
typing.Literal[Any]
default:"integration/blob-storage/aws/s3"
required
name
str
required
The name of the integration that will be displayed in the TrueFoundry UI.
storage_root
str
required
The S3 storage path in the format β€˜s3://<bucket-name>/<optional-path-prefix>’. Works with S3-compatible storage providers like MinIO, Ceph, and DigitalOcean Spaces. Example: β€˜s3://mybucket’ or β€˜s3://mybucket/artifacts/production’.
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:

AwsSagemakerProviderAccount

type
typing.Literal[Any]
default:"provider-account/aws-sagemaker"
required
name
str
required
The name of the Sagemaker provider account
region
AwsRegion
required
auth_data
typing.Optional[AwsSagemakerProviderAccountAuthData]
πŸ”— AwsSagemakerProviderAccountAuthDataAuthentication data for the AWS account
integrations
typing.List[SagemakerModel]
required
πŸ”— SagemakerModelList of integrations that are associated with the Sagemaker provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

AwsSagemakerProviderAccountAuthData

Union, One Of:

AwsSecretsManager

type
typing.Literal[Any]
default:"integration/secret-store/aws/secrets-manager"
required
name
str
required
The name of the integration that will be displayed in the TrueFoundry UI.
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>.
kms_arn
typing.Optional[str]
The ARN of the KMS key to use for encryption.

AwsSecretsManagerAuthData

Union, One Of:

AwsSqsAccessKeyBasedAuth

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.

AwsSqsAssumedRoleBasedAuth

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

AzureAksIntegration

type
typing.Literal[Any]
default:"integration/cluster/azure/aks"
required
name
str
required
The name of the integration that will be displayed in the TrueFoundry UI.
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
The name of the integration that will be displayed in the TrueFoundry UI.
storage_root
str
required
The full Azure Blob Storage URL in the format β€˜https://<storage-account-name>.blob.core.windows.net/<container-name>/<optional-path-prefix>’. Example: β€˜https://mystorageaccount.blob.core.windows.net/mycontainer’ or β€˜https://mystorageaccount.blob.core.windows.net/mycontainer/artifacts/production’.
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>.

AzureCertificateAuth

type
typing.Literal[Any]
default:"certificate"
required
tenant_id
str
required
The Azure AD tenant ID where the application is registered
client_id
str
required
The Azure AD application (client) ID for service principal authentication
certificate
str
required
Certificate in PEM format (e.g., -----BEGIN CERTIFICATE----- … -----END CERTIFICATE-----)
certificate_thumbprint
str
required
The base64url-encoded SHA-1 thumbprint of the certificate (x5t claim)

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
The name of the integration that will be displayed in the TrueFoundry UI.
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
The name of the Guardrail Config.
description
typing.Optional[str]
Optional description for this Guardrail Config.
type
typing.Literal[Any]
required
auth_data
AzureContentSafetyGuardrailConfigAuthData
required
πŸ”— AzureContentSafetyGuardrailConfigAuthDataAuthentication data for the Azure account
operation
typing.Literal[Any]
default:"validate"
required
The operation type for this guardrail. Azure Content Safety guardrails can only be used for validation.
enforcing_strategy
EnforcingStrategy
required
config
AzureContentSafetyGuardrailConfigConfig
required

AzureContentSafetyGuardrailConfigAuthData

Union, One Of:

AzureContentSafetyGuardrailConfigConfig

resource_name
str
required
Name of your Azure Content Safety resource where the service is deployed (e.g., my-content-safety)
api_version
str
default:"2024-09-01"
required
API version for the Content Safety API
custom_host
typing.Optional[str]
Custom endpoint URL for the Content Safety API (optional, uses default Azure endpoint if not specified)
blocklist_names
typing.Optional[typing.List[str]]
Names of custom blocklists created in Azure Content Safety to check text against. Leave empty if not using custom blocklists
severity_threshold
float
default:"2.0"
required
Minimum severity level (0-6) to flag content. Higher values are more restrictive. 0=Safe, 2=Low risk, 4=Medium risk, 6=High risk
categories
typing.List[AzureContentSafetyCategory]
required
πŸ”— AzureContentSafetyCategoryTypes of harmful content to detect: Hate (hate speech), SelfHarm (self-injury), Sexual (sexual content), Violence (violent content)

AzureFoundryModel

type
typing.Literal[Any]
default:"integration/model/azure-foundry"
required
name
str
required
A descriptive name to identify this model integration in the UI
auth_data
AzureFoundryModelAuthData
required
πŸ”— AzureFoundryModelAuthDataAzure AI Foundry authentication credentials
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeTypes of models supported by this Azure AI Foundry deployment
model_id
str
required
The model deployment name created in your Azure AI Foundry project. This is the deployment name you configured in Azure AI Foundry, not the base model name.
azure_endpoint
str
required
The Azure AI Foundry endpoint URL. Should look like https://{deployment}.{region}.models.ai.azure.com
api_version
typing.Optional[str]
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>.

AzureFoundryModelAuthData

Union, One Of:

AzureFoundryProviderAccount

type
typing.Literal[Any]
default:"provider-account/azure-foundry"
required
name
str
required
The name of the Azure AI Foundry provider account
integrations
typing.List[AzureFoundryModel]
required
πŸ”— AzureFoundryModelList 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
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

AzureIntegrations

Union, One Of:

AzureKeyAuth

type
typing.Literal[Any]
default:"api-key"
required
api_key
str
required
The API key for Azure AI Foundry authentication

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

type
typing.Literal[Any]
default:"integration/model/azure-openai"
required
name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The model deployment name created in your Azure OpenAI resource (e.g., gpt-4-deployment, gpt-35-turbo-deployment). This is NOT the base model name but the deployment name you configured in Azure.
api_version
str
required
The Azure OpenAI API version to use
foundation_model
typing.Optional[str]
The foundation model identifier (e.g., gpt-4o-2024-11-20)
deployment_type
AzureOpenAiModelDeploymentType
required
πŸ”— AzureOpenAiModelDeploymentTypeGlobal: worldwide processing; Data zone (US): US data zone processing; Data zone (EU): EU data zone processing; Standard: single-region processing
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
The name of the Azure OpenAI provider account
azure_endpoint
str
required
The Azure OpenAI Service endpoint URL. Should look like https://{resource-name}.openai.azure.com
auth_data
AzureOpenAiProviderAccountAuthData
required
πŸ”— AzureOpenAiProviderAccountAuthDataAzure OpenAI authentication credentials
integrations
typing.List[AzureOpenAiModel]
required
πŸ”— AzureOpenAiModelList 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
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

AzureOpenAiProviderAccountAuthData

Union, One Of:

AzurePiiGuardrailConfig

name
str
required
The name of the Guardrail Config.
description
typing.Optional[str]
Optional description for this Guardrail Config.
type
typing.Literal[Any]
default:"integration/guardrail-config/azure-pii"
required
auth_data
AzurePiiGuardrailConfigAuthData
required
πŸ”— AzurePiiGuardrailConfigAuthDataAuthentication data for the Azure account
operation
AzurePiiGuardrailConfigOperation
required
πŸ”— AzurePiiGuardrailConfigOperationThe 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.
priority
typing.Optional[int]
default:"1"
Execution order for mutate guardrails. Lower values run first. Only applicable when operation is mutate.
enforcing_strategy
EnforcingStrategy
required
config
AzurePiiGuardrailConfigConfig
required

AzurePiiGuardrailConfigAuthData

Union, One Of:

AzurePiiGuardrailConfigConfig

resource_name
str
required
Name of your Azure AI Language resource where the PII detection service is deployed (e.g., my-language-resource)
api_version
str
default:"2024-11-01"
required
API version for the PII detection API
custom_host
typing.Optional[str]
Custom endpoint URL for the PII detection API (optional, uses default Azure endpoint if not specified)
domain
AzurePiiGuardrailConfigConfigDomain
required
πŸ”— AzurePiiGuardrailConfigConfigDomainSpecialized domain for PII detection. Use phi for PHI (Protected Health Information) or none for general text
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, use latest for the newest model or specify a specific version for consistency
language
str
default:"en"
required
Language code for PII detection (e.g., en for English)

AzurePromptShieldGuardrailConfig

name
str
required
The name of the Guardrail Config.
description
typing.Optional[str]
Optional description for this Guardrail Config.
type
typing.Literal[Any]
required
auth_data
AzurePromptShieldGuardrailConfigAuthData
required
πŸ”— AzurePromptShieldGuardrailConfigAuthDataAuthentication data for the Azure account
operation
typing.Literal[Any]
default:"validate"
required
The operation type for this guardrail. Azure Prompt Shield guardrails can only be used for validation.
enforcing_strategy
EnforcingStrategy
required
config
AzurePromptShieldGuardrailConfigConfig
required

AzurePromptShieldGuardrailConfigAuthData

Union, One Of:

AzurePromptShieldGuardrailConfigConfig

resource_name
str
required
Name of your Azure Content Safety resource where the Prompt Shield service is deployed (e.g., my-content-safety)
api_version
str
default:"2024-09-01"
required
API version for the Prompt Shield API
custom_host
typing.Optional[str]
Custom endpoint URL for the Prompt Shield API (optional, uses default Azure endpoint if not specified)

AzureProviderAccount

type
typing.Literal[Any]
default:"provider-account/azure"
required
name
str
required
The name of the Azure provider account.
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.
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

AzureReposIntegration

type
typing.Literal[Any]
default:"integration/vcs/azure"
required
name
str
required
account_name
str
required
Account 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>.

AzureVault

type
typing.Literal[Any]
default:"integration/secret-store/azure/vault"
required
name
str
required
The name of the integration that will be displayed in the TrueFoundry UI.
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
Unique identifier for the artifact version
fqn
str
required
Fully qualified name of the artifact version in the format β€˜{artifact_type}:{tenant_name}/{ml_repo_name}/{artifact_name}:{version}’
created_by_subject
Subject
required
πŸ”— SubjectSubject (user, team, or service account) that created this artifact version
created_at
typing.Optional[dt.datetime]
Timestamp when the artifact version was created
updated_at
typing.Optional[dt.datetime]
Timestamp when the artifact version was last updated
manifest
typing.Optional[BaseArtifactVersionManifest]
ml_repo_id
str
required
ID of the ML Repo that this artifact version belongs to

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.

BaseRemoteAgent

name
str
required
The name of the Agent
description
str
required
The description of the Agent
tags
typing.Optional[typing.Dict[(str, typing.Any)]]
Tags for the Agent
collaborators
typing.List[Collaborator]
required
πŸ”— CollaboratorList of users who have access to this Agent
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

BaseService

name
str
required
Name of the service. This uniquely identifies this service in the workspace. > Name can only contain alphanumeric characters and ’-’ and can be atmost 25 characters long
image
BaseServiceImage
required
πŸ”— BaseServiceImageSpecify whether you want to deploy a Docker image or build and deploy from source code
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)]]
Labels
kustomize
typing.Optional[Kustomize]
liveness_probe
typing.Optional[HealthProbe]
readiness_probe
typing.Optional[HealthProbe]
startup_probe
typing.Optional[HealthProbe]
workspace_fqn
typing.Optional[str]
Fully qualified name of the workspace

BaseServiceImage

Union, One Of:

BaseServiceMountsItem

Union, One Of:

BasetenKeyAuth

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

BasetenModel

type
typing.Literal[Any]
default:"integration/model/baseten"
required
name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The Baseten model identifier. This is the model name from Baseten’s model catalog.
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the Baseten 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>.

BasetenProviderAccount

type
typing.Literal[Any]
default:"provider-account/baseten"
required
name
str
required
The name of the Baseten provider account
auth_data
BasetenKeyAuth
required
integrations
typing.Optional[typing.List[BasetenIntegrations]]
List of integrations that are associated with the Baseten provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

BaseWorkbenchInput

name
str
required
Name of the workbench. This uniquely identifies this workbench in the workspace. > Name can only contain alphanumeric characters and ’-’ and can be atmost 25 characters long
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]
Fully qualified name of the workspace

BaseWorkbenchInputMountsItem

Union, One Of:

BasicAuthCreds

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

BedrockModel

name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The AWS Bedrock model identifier or inference profile. Can be a foundation model ID (e.g., anthropic.claude-3-5-sonnet-20240620-v1:0, amazon.titan-text-express-v1), an inference profile ID (e.g., us.anthropic.claude-3-5-sonnet-20240620-v1:0), or an inference profile ARN (e.g., arn:aws:bedrock:us-east-1:123456789012:inference-profile/my-profile).
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
Account 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>.

BitbucketProviderAccount

type
typing.Literal[Any]
default:"provider-account/bitbucket"
required
name
str
required
integrations
typing.List[BitbucketIntegration]
required
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

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]
Promote the new release to handle the complete traffic. A manual promotion would be needed if this is disabled
auto_promotion_seconds
typing.Optional[int]
default:"30"
Promote the new release to handle the complete traffic after waiting for these many seconds

BudgetAlert

thresholds
typing.List[float]
required
List of usage percentages (0-100) at which alerts should be triggered. Default thresholds are [75, 90, 95, 100].
notification_target
typing.List[NotificationTarget]
required
πŸ”— NotificationTargetSelect where to send budget alert notifications

BudgetConfig

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
budget_applies_per
typing.Optional[typing.List[str]]
Create separate budget rules for each unique value of the selected entity. For example, if β€œuser” is selected, a separate budget rule will be created for each unique user making requests. Options: user, virtualaccount, model, or a metadata key (e.g., metadata.appId).
alerts
typing.Optional[BudgetAlert]
audit_mode
typing.Optional[bool]
When enabled, requests exceeding the budget are tracked but not blocked

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
πŸ”— BuildBuildSourceSource code location.
build_spec
BuildBuildSpec
required
πŸ”— BuildBuildSpecInstructions to build a container image out of the build source

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

BuildSecret

id
str
required
The ID of the build secret.
value
str
required
The value of the build secret.
env
typing.Optional[str]
The name of the environment variable to inject the secret into.

Canary

type
typing.Literal[Any]
default:"canary"
required
steps
typing.List[CanaryStep]
required
πŸ”— CanaryStepThese steps would be executed in order to enable shifting of traffic slowly from stable to canary version

CanaryStep

weight_percentage
int
required
Percentage of total traffic to be shifted to the canary release. The rest will continue to go to the existing deployment
pause_duration
typing.Optional[int]
Duration for which to pause the release. The release process will wait for these seconds before proceeding to the next step. If this is not set, the step will pause indefinitely on this step

CartesiaApiKeyAuth

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

CartesiaModel

type
typing.Literal[Any]
default:"integration/model/cartesia"
required
name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The Cartesia model identifier (for example, sonic-2, sonic-multilingual)
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the Cartesia model (text_to_speech or audio_transcription)
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>.

CartesiaProviderAccount

type
typing.Literal[Any]
default:"provider-account/cartesia"
required
name
str
required
The name of the Cartesia provider account
base_url
typing.Optional[str]
Optional custom base URL for Cartesia API
cartesia_version
CartesiaProviderAccountCartesiaVersion
required
πŸ”— CartesiaProviderAccountCartesiaVersionThe Cartesia API version header. Must be set to a supported API version.
auth_data
CartesiaApiKeyAuth
required
integrations
typing.List[CartesiaModel]
required
πŸ”— CartesiaModelList of integrations that are associated with the Cartesia provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

CedarGuardrailConfig

name
str
required
The name of the Guardrail Config.
description
typing.Optional[str]
Optional description for this Guardrail Config.
type
typing.Literal[Any]
default:"integration/guardrail-config/cedar"
required
operation
typing.Literal[Any]
default:"validate"
required
The operation type for this guardrail. Cedar guardrails can only be used for validation.
enforcing_strategy
EnforcingStrategy
required
config
CedarGuardrailConfigConfig
required

CedarGuardrailConfigConfig

policy
str
required
Enter a Cedar policy string to define access control rules. Supports principal types (user, team, virtualaccount), MCPTool actions, MCPServer resources, and when/unless clauses, refer to Docs

CerebrasKeyAuth

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

CerebrasModel

type
typing.Literal[Any]
default:"integration/model/cerebras"
required
name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The Cerebras model identifier (e.g., llama-4-scout-17b-16e-instruct, llama3.1-70b). This is the standard model name from Cerebras’s API documentation.
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the Cerebras 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>.

CerebrasProviderAccount

type
typing.Literal[Any]
default:"provider-account/cerebras"
required
name
str
required
The name of the Cerebras provider account
auth_data
CerebrasKeyAuth
required
integrations
typing.Optional[typing.List[CerebrasIntegrations]]
List of integrations that are associated with the Cerebras provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

ChangePasswordResponse

Union, One Of:

ChatPromptManifest

name
str
required
Name of the prompt (alphanumeric characters, hyphens, and underscores only, max 256 characters)
metadata
typing.Dict[(str, typing.Any)]
required
Key value metadata. Should be valid JSON. For e.g. \{"business-unit": "sales", "quality": "good", "rating": 4.5\}
ml_repo
str
required
Name of the ML Repo that this prompt belongs to (must start and end with alphanumeric, 2-100 characters)
version
typing.Optional[int]
Version of the entity
type
typing.Literal[Any]
default:"chat_prompt"
required
description
typing.Optional[str]
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)
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]
response_format
typing.Optional[ChatPromptManifestResponseFormat]
πŸ”— ChatPromptManifestResponseFormatResponse format configuration for structured outputs
routing_config
typing.Optional[ChatPromptManifestRoutingConfig]
πŸ”— ChatPromptManifestRoutingConfigConfiguration for routing requests to different model targets
cache_config
typing.Optional[ChatPromptManifestCacheConfig]
πŸ”— ChatPromptManifestCacheConfigCache configuration for the chat prompt
tool_call_to_mcp_mapping
typing.Optional[typing.Dict[(str, McpServerToolDetails)]]
πŸ”— McpServerToolDetailsMapping of tool calls to MCP server integration IDs and tool names
logging_config
typing.Optional[LoggingConfig]
sub_agents
typing.Optional[typing.List[SubAgent]]
πŸ”— SubAgentSub agents to be used in the chat prompt

ChatPromptManifestCacheConfig

Union, One Of:

ChatPromptManifestMcpServersItem

Union, One Of:

ChatPromptManifestMessagesItem

Union, One Of:

ChatPromptManifestResponseFormat

Union, One Of:

ChatPromptManifestRoutingConfig

Union, One Of:

ClouderaModel

type
typing.Literal[Any]
default:"integration/model/cloudera"
required
name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The unique identifier of the Model in Cloudera Model Registry. This is the model ID assigned when you registered or deployed your model in the CDP Model Registry
base_url
str
required
The model endpoint URL up to the API version v1. To get the base_url, copy the model endpoint URL and delete the last two path components
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the Cloudera 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>.

ClouderaProviderAccount

type
typing.Literal[Any]
default:"provider-account/cloudera"
required
name
str
required
The name of the Cloudera provider account
auth_data
ClouderaProviderAccountAuthData
required
πŸ”— ClouderaProviderAccountAuthDataCloudera authentication credentials
integrations
typing.List[ClouderaIntegrations]
required
List of integrations that are associated with the Cloudera provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

ClouderaProviderAccountAuthData

Union, One Of:

ClouderaTokenAuth

type
typing.Literal[Any]
default:"token"
required
api_token
str
required
Pre-generated API token for Cloudera CDP authentication. You can generate this token using the CDP CLI or from your user profile settings. This token provides direct access to CDP services without requiring workload-specific authentication.

ClouderaWorkloadAuthToken

type
typing.Literal[Any]
default:"workload-auth-token"
required
cdp_base_url
str
required
The base URL for CDP API services
access_key_id
str
required
The access key ID for your Cloudera CDP workload authentication.
private_key
str
required
The private key for your Cloudera CDP workload authentication.
workload_name
str
required
The name of the CDP workload you want to authenticate with.

Cluster

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

ClusterGateway

uid
typing.Optional[str]
name
str
required
hosts
typing.List[str]
required
is_tie_breaker
typing_extensions.Annotated[(typing.Optional[bool], Any, Any)]
selector
typing.Dict[(str, str)]
required

ClusterManifest

type
typing.Literal[Any]
default:"cluster"
required
name
str
required
Name - 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]]
One or more base URLs, which can be either a wildcard domain (resulting in app URLs like \<app-name\>-\<workspace-name\>.\<base-domain-URL\>) or a non-wildcard domain (resulting in app URLs like \<base-domain-URL\>/\<app-name\>-\<workspace-name\>) > Read more about routing here and about β€˜A’ record and domain mapping here
monitoring
typing.Optional[ClusterManifestMonitoring]
default_registry_fqn
typing.Optional[str]
Cluster Default Registry
workbench_config
typing.Optional[ClusterManifestWorkbenchConfig]
spark_config
typing.Optional[SparkConfig]
ingress_controller_config
typing.Optional[IngressControllerConfig]
cluster_integration_fqn
typing.Optional[str]
Cluster Integration FQN
workflow_storage_integration_fqn
typing.Optional[str]
Workflow Storage Integration
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
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

ClusterManifestMonitoring

loki_url
typing.Optional[str]
Cluster Loki URL
victoria_logs_url
typing.Optional[str]
Cluster VictoriaLogs URL
prometheus_url
typing.Optional[str]
Cluster Prometheus URL
kubecost_url
typing.Optional[str]
Cluster Kubecost URL

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]
The default storage class for the home directory of workbench

ClustersDeleteResponse

message
typing.Optional[str]
Success message

CodeSafetyLinterGuardrailConfig

name
str
required
The name of the Guardrail Config.
description
typing.Optional[str]
Optional description for this Guardrail Config.
type
typing.Literal[Any]
default:"integration/guardrail-config/code-safety-linter"
required
operation
typing.Literal[Any]
default:"validate"
required
The operation type for this guardrail. Code Safety Linter guardrails can only be used for validation.
enforcing_strategy
EnforcingStrategy
required

Codeserver

type
typing.Literal[Any]
default:"codeserver"
required
image
WorkbenchImage
required

CohereKeyAuth

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

CohereModel

type
typing.Literal[Any]
default:"integration/model/cohere"
required
name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The Cohere model identifier (e.g., command-a-03-2025, command-r-03-2024, command-r-03-2024). This is the standard model id from Cohere’s model catalog.
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
The name of the Cohere provider account
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
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

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.
sandbox_exec
bool
required
Enable sandbox executor tool Allows model to execute shell command in an isolated stateful sandbox environment.
sequential_thinking
bool
required
Enable sequential thinking tool Allows model to reason step-by-step to solve complex problems.
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
πŸ”— ContainerTaskConfigImageSpecify whether you want to deploy a Docker image or build and deploy from source code
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[ContainerTaskConfigMountsItem]]
πŸ”— ContainerTaskConfigMountsItemConfigure data to be mounted to Workflow pod(s) as a volume.
service_account
typing.Optional[str]
Service Account

ContainerTaskConfigImage

Union, One Of:

ContainerTaskConfigMountsItem

Union, One Of:

CoreNatsOutputConfig

type
typing.Literal[Any]
default:"core-nats"
required
nats_url
str
required
Output NATS URL
root_subject
str
required
Root subject of output NATS
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

CreateDockerRepositoryResponse

repo_name
typing_extensions.Annotated[(str, Any, Any)]
required

CreateMultiPartUploadRequest

id
str
required
ID of the artifact version to upload files to
path
str
required
Relative path within the artifact version where the file should be uploaded
num_parts
int
required
Number of parts to split the upload into for multipart upload

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

CustomAgentServerAuth

Union, One Of:

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
The name of the integration that will be displayed in the TrueFoundry UI.
endpoint
str
required
The endpoint of the storage provider.
storage_root
str
required
The S3-compatible storage path in the format β€˜s3://<bucket-name>/<optional-path-prefix>’. Works with S3-compatible storage providers like MinIO, Ceph, and DigitalOcean Spaces. Example: β€˜s3://mybucket’ or β€˜s3://mybucket/artifacts/production’.
region
typing.Optional[str]
The region where the storage is located.
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>.

CustomEndpoint

type
typing.Literal[Any]
default:"integration/model/custom-endpoint"
required
name
str
required
A descriptive name to identify this endpoint in the UI
base_url
str
required
The target base URL to proxy requests to (e.g., https://my-service.example.com/v1)
auth_data
typing.Optional[CustomHeaderAuth]
headers
typing.Optional[typing.Dict[(str, str)]]
Custom headers forwarded to the upstream endpoint with every request. For example: \{"X-Custom-Header": "value"\}
tls_settings
typing.Optional[CustomTlsSettings]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this endpoint. List of user fqn in format <user_type>:<username>.

CustomEndpointProviderAccount

type
typing.Literal[Any]
default:"provider-account/custom-endpoint"
required
name
str
required
The name of the custom endpoint provider account.
endpoint_type
typing.Optional[CustomEndpointProviderAccountEndpointType]
πŸ”— CustomEndpointProviderAccountEndpointTypeThe type of service behind this endpoint (used for tracking purposes)
auth_data
typing.Optional[CustomHeaderAuth]
integrations
typing.List[CustomEndpointIntegrations]
required
πŸ”— CustomEndpointList of endpoint integrations associated with this provider account.
collaborators
typing.Optional[typing.List[Collaborator]]
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

CustomFramework

type
typing.Literal[Any]
default:"custom"
required
Type

CustomGuardrailConfig

name
str
required
The name of the Guardrail Config.
description
typing.Optional[str]
Optional description for this Guardrail Config.
type
typing.Literal[Any]
default:"integration/guardrail-config/custom"
required
auth_data
typing.Optional[CustomGuardrailConfigAuthData]
πŸ”— CustomGuardrailConfigAuthDataAuthentication data for the Guardrail Server.
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.
priority
typing.Optional[int]
default:"1"
Execution order for mutate guardrails. Lower values run first. Only applicable when operation is mutate.
enforcing_strategy
EnforcingStrategy
required
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.
config
CustomGuardrailConfigConfig
required

CustomGuardrailConfigAuthData

Union, One Of:

CustomGuardrailConfigConfig

url
str
required
The URL of the Guardrail to send a post request to.
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.Optional[typing.Dict[(str, 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.

CustomHeaderAuth

type
typing.Literal[Any]
default:"header"
required
headers
typing.Dict[(str, str)]
required
Headers passed to the generic secret server with every request.

CustomHelmRepo

type
typing.Literal[Any]
default:"integration/helm-repo/custom"
required
name
str
required
The name of the integration that will be displayed in the TrueFoundry UI.
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
The name of the integration that will be displayed in the TrueFoundry UI.
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>.

CustomProviderAccount

type
typing.Literal[Any]
default:"provider-account/custom"
required
name
str
required
The name of the provider account.
auth_data
typing.Optional[CustomBasicAuth]
integrations
typing.List[CustomIntegrations]
required
πŸ”— CustomIntegrationsList of integrations that are associated with the provider account.
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

CustomRegexPattern

pattern
str
required
A custom regex pattern to match against content (e.g., β€œ\b\d{3}-\d{2}-\d{4}\b” for SSN)
redaction_text
typing.Optional[str]
default:"[REDACTED]"
Text to use when redacting matched content (only applicable in mutate mode). Defaults to β€˜[REDACTED]’.

CustomServerHeaderAuth

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

CustomServerPassthrough

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

CustomTlsSettings

reject_unauthorized
bool
required
When set to true, it will reject any connection which is not authorized with the list of supplied CAs.
ca_cert
typing.Optional[str]
Add custom CA certificates to use for TLS verification.

CustomUsernamePasswordArtifactsRegistry

type
typing.Literal[Any]
default:"integration/docker-registry/custom"
required
name
str
required
The name of the integration that will be displayed in the TrueFoundry UI.
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>.

DataAccessRule

Union, One Of:

DataAccessRuleBase

id
str
required
Unique identifier for the rule
description
typing.Optional[str]
Description of the rule
enabled
typing.Optional[bool]
Whether this rule is enabled
subjects
typing.List[str]
required
List of subjects that this rule applies to (users, teams, roles)
data_types
typing.List[GatewayDataType]
required
πŸ”— GatewayDataTypeList of data types that this rule applies to

DatabricksApiKeyAuth

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

DatabricksJobTaskConfig

type
typing.Literal[Any]
default:"databricks-job-task-config"
required
image
DatabricksJobTaskConfigImage
required
πŸ”— DatabricksJobTaskConfigImageSpecify the image spec for the task
workspace_host
str
required
Databricks workspace URL, e.g. https://<workspace>.cloud.databricks.com
job_id
str
required
The Databricks job ID to run (from Databricks workspace Jobs).
service_account
typing.Optional[str]
Service Account
job_parameters
typing.Optional[typing.Dict[(str, typing.Optional[str])]]
Optional parameters to pass to the job run (e.g. notebook params, jar params).
timeout_seconds
typing.Optional[float]
Maximum seconds to wait for the job run to complete. Used by CLI when polling.
skip_wait_for_completion
typing.Optional[bool]
If false, the task waits for the Databricks job run to complete (trigger and poll). If true, only triggers the job and returns. Default false.
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]

DatabricksJobTaskConfigImage

Union, One Of:

DatabricksModel

type
typing.Literal[Any]
default:"integration/model/databricks"
required
name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The serving endpoint name configured in your Databricks workspace. This is the endpoint you created in Databricks Model Serving, not the underlying model name.
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
The name of the Databricks provider account
auth_data
DatabricksProviderAccountAuthData
required
πŸ”— DatabricksProviderAccountAuthDataDatabricks authentication credentials
base_url
str
required
The base URL of your Databricks workspace
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
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

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
Unique identifier for the data directory
ml_repo_id
str
required
ID of the ML Repo that this data directory belongs to
name
str
required
Name of the data directory
fqn
str
required
Fully qualified name of the data directory
created_by_subject
Subject
required
πŸ”— SubjectSubject (user, team, or service account) that created this data directory
created_at
dt.datetime
required
Timestamp when the data directory was created
updated_at
dt.datetime
required
Timestamp when the data directory was last updated
manifest
DataDirectoryManifest
required
πŸ”— DataDirectoryManifestManifest containing metadata for the data directory
usage_code_snippet
typing.Optional[str]
Code snippet demonstrating how to use this data directory

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.Any)]
required
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:

DeepgramApiKeyAuth

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

DeepgramModel

type
typing.Literal[Any]
default:"integration/model/deepgram"
required
name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The Deepgram model identifier (for example, nova-2, nova-2-general, aura-asteria-en)
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the Deepgram model (text_to_speech or audio_transcription)
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>.

DeepgramProviderAccount

type
typing.Literal[Any]
default:"provider-account/deepgram"
required
name
str
required
The name of the Deepgram provider account
auth_data
DeepgramApiKeyAuth
required
base_url
typing.Optional[str]
Optional custom base URL for Deepgram API
integrations
typing.List[DeepgramModel]
required
πŸ”— DeepgramModelList of integrations that are associated with the Deepgram provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

DeepinfraKeyAuth

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

DeepinfraModel

type
typing.Literal[Any]
default:"integration/model/deepinfra"
required
name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The DeepInfra model identifier (e.g., meta-llama/Llama-3.3-70B-Instruct-Turbo, mistralai/Mistral-Small-24B-Instruct-2501). This is the full model path from DeepInfra’s model catalog.
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
The name of the DeepInfra provider account
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
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

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:

DeleteUserResponse

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, Any)]
manifest
DeploymentManifest
required
application
typing.Optional[Any]
created_by_subject
typing_extensions.Annotated[(Subject, Any, Any)]
required
created_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any, Any)]
updated_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any, Any)]
deployment_builds
typing_extensions.Annotated[(typing.Optional[typing.List[BuildInfo]], Any, Any)]
deployment_statuses
typing_extensions.Annotated[(typing.Optional[typing.List[DeploymentStatus]], Any, Any)]
current_status_id
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
current_status
typing_extensions.Annotated[(typing.Optional[DeploymentStatus], Any, Any)]
applied_recommendations
typing_extensions.Annotated[(typing.Optional[typing.List[Recommendation]], Any, Any)]
created_by
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]

DeploymentBuild

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

DeploymentManifest

Union, One Of:

DeploymentStatus

id
typing.Optional[str]
deployment_id
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
status
typing.Optional[DeploymentStatusValue]
state
typing.Optional[typing.Dict[(str, typing.Any)]]
transition
typing.Optional[DeploymentTransition]
message
typing.Optional[str]
retry_count
typing_extensions.Annotated[(typing.Optional[float], Any, Any)]
created_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any, Any)]
updated_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any, 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)]]
Build arguments to pass to docker build
build_secrets
typing.Optional[typing.List[BuildSecret]]
πŸ”— BuildSecretBuild secrets you can use in run statements inside dockerfile like RUN β€”mount=type=secret,id=pip_index_url … you can learn more about build secrets here https://www.truefoundry.com/docs/docker-build-secrets

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 36 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
account_name
typing.Optional[str]
Account Name
auth_data
typing.Optional[DockerhubBasicAuth]
integrations
typing.List[DockerhubIntegrations]
required
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

DockerhubRegistry

type
typing.Literal[Any]
default:"integration/docker-registry/dockerhub"
required
name
str
required
The name of the integration that will be displayed in the TrueFoundry UI.
registry_url
str
required
Registry URL
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

ElevenLabsApiKeyAuth

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

ElevenLabsModel

type
typing.Literal[Any]
default:"integration/model/elevenlabs"
required
name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The ElevenLabs model identifier (for example, eleven_multilingual_v2, eleven_turbo_v2_5)
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the ElevenLabs model (text_to_speech or audio_transcription)
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>.

ElevenLabsProviderAccount

type
typing.Literal[Any]
default:"provider-account/elevenlabs"
required
name
str
required
The name of the ElevenLabs provider account
auth_data
ElevenLabsApiKeyAuth
required
base_url
typing.Optional[str]
Optional custom base URL for ElevenLabs API
integrations
typing.List[ElevenLabsModel]
required
πŸ”— ElevenLabsModelList of integrations that are associated with the ElevenLabs provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

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
The name of the integration that will be displayed in the TrueFoundry UI.
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
Host e.g. ai.example.com, app.truefoundry.com
path
typing.Optional[str]
Path e.g. /v1/api/ml/, /v2/docs/

EnkryptAiGuardrailConfig

name
str
required
The name of the Guardrail Config.
description
typing.Optional[str]
Optional description for this Guardrail Config.
type
typing.Literal[Any]
default:"integration/guardrail-config/enkrypt-ai"
required
auth_data
EnkryptAiKeyAuth
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.
priority
typing.Optional[int]
default:"1"
Execution order for mutate guardrails. Lower values run first. Only applicable when operation is mutate.
enforcing_strategy
EnforcingStrategy
required
config
EnkryptAiGuardrailConfigConfig
required

EnkryptAiGuardrailConfigConfig

guardrail_name
str
required
The name of the guardrail to use for the Enkrypt AI Guardrail.

EnkryptAiKeyAuth

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

Environment

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

EnvironmentColor

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

EnvironmentManifest

type
typing.Literal[Any]
default:"environment"
required
name
str
required
Environment Name
color
EnvironmentColor
required
is_production
typing_extensions.Annotated[(bool, Any, Any)]
required
optimize_for
typing_extensions.Annotated[(EnvironmentOptimizeFor, Any, Any)]
required

Event

name
typing.Optional[str]
Name of the event
first_timestamp
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
last_timestamp
typing_extensions.Annotated[(str, Any, Any)]
required
involved_object
typing_extensions.Annotated[(EventInvolvedObject, Any, Any)]
required
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, Any)]
namespace
typing.Optional[str]
container_name
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]

ExactMatchCacheConfig

type
typing.Literal[Any]
default:"exact-match"
required
namespace
typing.Optional[str]
Cache namespace (defaults to β€˜default’ if not provided)
ttl
float
default:"3600.0"
required
Time-to-live for cached entries in seconds (max 3 days)

ExternalBlobStorageSource

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

FastAiFramework

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

FiddlerGuardrailConfig

name
str
required
The name of the Guardrail Config.
description
typing.Optional[str]
Optional description for this Guardrail Config.
type
typing.Literal[Any]
default:"integration/guardrail-config/fiddler"
required
auth_data
FiddlerKeyAuth
required
operation
typing.Literal[Any]
default:"validate"
required
The operation type for this guardrail. Fiddler guardrails can only be used for validation.
enforcing_strategy
EnforcingStrategy
required
config
FiddlerGuardrailConfigConfig
required

FiddlerGuardrailConfigConfig

guard_type
FiddlerGuardType
required
threshold
typing.Optional[float]
Confidence threshold (0.0-1.0) for flagging content. Content scoring above the threshold will be flagged

FiddlerKeyAuth

type
typing.Literal[Any]
default:"api-key"
required
api_key
str
required
API key for the Fiddler account

FileInfo

path
str
required
Relative path of the file or directory within the artifact version
is_dir
bool
required
Whether this path represents a directory (true) or a file (false)
file_size
typing.Optional[int]
Size of the file in bytes (only present for files, not directories)
signed_url
typing.Optional[str]
Pre-signed URL to download the file directly (only present for files)
last_modified
typing.Optional[dt.datetime]
Timestamp when the file was last modified

FlyteLaunchPlan

id
FlyteLaunchPlanId
required
spec
FlyteLaunchPlanSpec
required
closure
typing.Any
required

FlyteLaunchPlanId

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

FlyteLaunchPlanSpec

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

FlyteTask

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

FlyteTaskCustom

truefoundry
FlyteTaskCustomTruefoundry
required

FlyteTaskCustomTruefoundry

Union, One Of:

FlyteTaskId

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

FlyteTaskTemplate

id
FlyteTaskId
required
custom
FlyteTaskCustom
required

FlyteWorkflow

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

FlyteWorkflowId

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

FlyteWorkflowTemplate

id
FlyteWorkflowId
required

ForwardAction

type
typing.Literal[Any]
default:"forward"
required
service_uri
str
required
Service uri to redirect to. This is the kubernetes fully qualified domain name that the target service can be reached on Eg - For a service called sample-service in workspace ws this would be `sample-service.ws.svc.cluster.local
port
int
required
Port to redirect the service traffic to

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
typing.Optional[str]
Description of the function
parameters
typing.Optional[typing.Dict[(str, typing.Any)]]
Parameters schema for the function
strict
typing.Optional[bool]
Indicates if the function should be called strictly

GatewayConfig

Union, One Of:

GatewayConfiguration

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

GatewayDataAccessConfig

type
typing.Literal[Any]
default:"gateway-data-access-config"
required
rules
typing.List[DataAccessRule]
required
πŸ”— DataAccessRuleList of data access rules

GatewayDataCreatedByFilter

field
typing.Literal[Any]
default:"created_by"
required
Filter type
operator
typing.Literal[Any]
default:"IN"
required
Comparison operator
value
typing.List[str]
required
List of subjects (users, virtual accounts, teams) to filter by

GatewayDataMetadataFilter

field
typing.Literal[Any]
default:"metadata"
required
Filter type
key
str
required
Metadata key to filter on
operator
typing.Literal[Any]
default:"IN"
required
Comparison operator
value
typing.List[str]
required
Values to match against

GatewayDataRoutingConfig

type
typing.Literal[Any]
default:"gateway-data-routing-config"
required
Type of configuration
destinations
typing.Optional[typing.List[GatewayDataRoutingConfigDestination]]
πŸ”— GatewayDataRoutingConfigDestinationList of conditional routing destinations
default
GatewayDataRoutingConfigDestinationStorage
required

GatewayDataRoutingConfigDestination

name
str
required
Name for the destination
enabled
bool
required
Whether this destination is enabled
description
typing.Optional[str]
Description of the destination
when
typing.List[GatewayDataRoutingConfigDestinationCondition]
required
πŸ”— GatewayDataRoutingConfigDestinationConditionConditions that must be met to use this destination

GatewayDataRoutingConfigDestinationCondition

Union, One Of:

GatewayDataRoutingConfigDestinationControlPlaneManagedStorage

type
typing.Literal[Any]
default:"controlplane-managed"
required
Type of storage configuration
region
typing.Optional[GatewayDataRoutingConfigDestinationControlPlaneManagedStorageRegion]
πŸ”— GatewayDataRoutingConfigDestinationControlPlaneManagedStorageRegionSpecifies the region where control plane–managed storage is located.

GatewayDataRoutingConfigDestinationCreatedByCondition

field
typing.Literal[Any]
default:"created_by"
required
Field to evaluate the condition on
operator
typing.Literal[Any]
default:"IN"
required
Operator to use for comparison
value
typing.List[str]
required
Value to compare against

GatewayDataRoutingConfigDestinationCustomerManagedStorage

type
typing.Literal[Any]
default:"customer-managed"
required
Type of storage configuration
storage_integration_fqn
str
required
Storage Integration FQN to store traces and spans. A storage integration represents a connected blob storage like AWS S3 / Azure Blob Storage / Google Cloud Storage.

GatewayDataRoutingConfigDestinationMetadataCondition

field
typing.Literal[Any]
default:"metadata"
required
Field to evaluate the condition on
key
str
required
Metadata key to match
operator
typing.Literal[Any]
default:"IN"
required
Operator to use for comparison
value
typing.List[str]
required
Value to compare against

GatewayDataRoutingConfigDestinationStorage

storage
GatewayDataRoutingConfigDestinationStorageStorage
required
πŸ”— GatewayDataRoutingConfigDestinationStorageStorageStorage configuration for traces and spans
traces_retention_period_days
typing.Optional[int]
Number of days to retain traces (this does not affect metrics storage)

GatewayDataRoutingConfigDestinationStorageStorage

Union, One Of:

GatewayLoggingConfig

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

GatewayLoggingRule

id
str
required
Unique identifier for the rule
when
GatewayLoggingWhen
required
tracing_project_fqn
str
required
FQN of the tracing project to send logs to

GatewayLoggingWhen

subjects
typing.Optional[typing.List[str]]
List of subjects that this rule applies to

GatewayMetadataConfig

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

GatewayMetadataRule

id
str
required
Unique identifier for the rule
when
GatewayMetadataWhen
required
metadata_override
typing.Dict[(str, str)]
required
Metadata key-value pairs to override in the request metadata

GatewayMetadataWhen

subjects
typing.Optional[typing.List[str]]
List of subjects that this rule applies to

GatewayOtelConfig

type
typing.Literal[Any]
default:"gateway-otel-config"
required
otel_traces_exporter_config
typing.Optional[GatewayOtelConfigOtelTracesExporterConfig]
πŸ”— GatewayOtelConfigOtelTracesExporterConfigSet this configuration to export LLM gateway OTEL traces to an external platform. Note that we only export OTEL traces via this configuration.
otel_metrics_exporter_config
typing.Optional[GatewayOtelConfigOtelMetricsExporterConfig]
πŸ”— GatewayOtelConfigOtelMetricsExporterConfigSet this configuration to export LLM gateway OTEL metrics to an external platform. Note that we only export OTEL metrics via this configuration.

GatewayOtelConfigOtelMetricsExporterConfig

Union, One Of:

GatewayOtelConfigOtelTracesExporterConfig

Union, One Of:

GatewayRequestMetadataFilter

gateway_request_metadata_key
typing_extensions.Annotated[(str, Any, Any)]
required
operator
GatewayRequestMetadataFilterOperator
required
value
GatewayRequestMetadataFilterValue
required

GatewayRequestMetadataFilterValue

Union, One Of:

GcpApiKeyAuth

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

GcpGcr

type
typing.Literal[Any]
default:"integration/docker-registry/gcp/gcr"
required
name
str
required
The name of the integration that will be displayed in the TrueFoundry UI.
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
The name of the integration that will be displayed in the TrueFoundry UI.
storage_root
str
required
The Google Cloud Storage path in the format β€˜gs://<bucket-name>/<optional-path-prefix>’. Example: β€˜gs://mybucket’ or β€˜gs://mybucket/artifacts/production’.
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
The name of the integration that will be displayed in the TrueFoundry UI.
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
The name of the integration that will be displayed in the TrueFoundry UI.
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
GcpKeyFileAuthKeyFileContent
required
πŸ”— GcpKeyFileAuthKeyFileContentKey File Content - Key file content must be valid JSON

GcpKeyFileAuthKeyFileContent

Union, One Of:

GcpProviderAccount

type
typing.Literal[Any]
default:"provider-account/gcp"
required
name
str
required
The name of the GCP provider account.
project_id
typing.Optional[str]
The project id of the GCP account.
auth_data
typing.Optional[GcpKeyFileAuth]
integrations
typing.List[GcpIntegrations]
required
πŸ”— GcpIntegrationsList of integrations that are associated with the GCP provider account.
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

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

GeminiModel

type
typing.Literal[Any]
default:"integration/model/gemini"
required
name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The Google Gemini model identifier (e.g., gemini-2.0-flash, gemini-2.0-flash-lite-preview-02-05, gemini-2.0-flash-lite-preview-02-05). This is the standard model name from Google’s Gemini API documentation.
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>.

GenericSecretStoreIntegration

type
typing.Literal[Any]
default:"integration/secret-store/custom/generic"
required
name
str
required
The name of the integration that will be displayed in the TrueFoundry UI.
base_url
str
required
Base URL of the generic secret server.
auth_data
CustomHeaderAuth
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>.

GetAgentSkillResponse

data
AgentSkill
required
πŸ”— AgentSkillThe agent skill data

GetAgentSkillVersionResponse

data
AgentSkillVersion
required
πŸ”— AgentSkillVersionThe agent skill version data

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
πŸ”— ArtifactThe artifact data

GetArtifactVersionResponse

data
ArtifactVersion
required
πŸ”— ArtifactVersionThe artifact version data

GetAuthenticatedVcsurlResponse

authenticated_url
typing_extensions.Annotated[(str, Any, Any)]
required

GetAutoProvisioningStateResponse

state
typing.Optional[typing.Dict[(str, 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
πŸ”— DataDirectoryThe data directory data

GetDockerRegistryCredentialsResponse

fqn
str
required
Docker registry FQN
registry_url
typing_extensions.Annotated[(str, Any, Any)]
required
username
str
required
Docker registry username
password
str
required
Docker registry password

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
πŸ”— ModelThe model data

GetModelVersionResponse

data
ModelVersion
required
πŸ”— ModelVersionThe model version data

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
πŸ”— PromptThe prompt data

GetPromptVersionResponse

data
PromptVersion
required
πŸ”— PromptVersionThe prompt version data

GetSecretGroupResponse

data
SecretGroup
required

GetSecretResponse

data
Any
required
Secret

GetSignedUrLsRequest

id
str
required
ID of the artifact version to get signed URLs for
paths
typing.List[str]
required
List of relative file paths within the artifact version to get signed URLs for
operation
Operation
required
πŸ”— OperationOperation type for the signed URL (e.g., β€˜READ’ or β€˜WRITE’)

GetSignedUrLsResponse

data
typing.List[SignedUrl]
required
πŸ”— SignedUrlList of signed URLs for the requested file paths

GetSuggestedDeploymentEndpointResponse

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

GetTeamPermissionsResponse

data
typing.List[SubjectPermission]
required
πŸ”— SubjectPermissionRole bindings for the team

GetTeamResponse

data
Team
required

GetTokenForVirtualAccountResponse

token
str
required
Token for the virtual account

GetUserPermissionsResponse

data
typing.List[SubjectPermission]
required
πŸ”— SubjectPermissionRole bindings for the user (including team-inherited)

GetUserResourcesResponse

data
typing.List[UserResource]
required
πŸ”— UserResourceResources where user is a collaborator

GetUserResponse

data
User
required

GetUserTeamsResponse

data
typing.List[UserTeamInfo]
required
πŸ”— UserTeamInfoTeams where user is a member, with their role

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
Git repository URL - 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
Account 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>.

GithubProviderAccount

type
typing.Literal[Any]
default:"provider-account/github"
required
name
str
required
integrations
typing.List[GithubIntegration]
required
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

GitlabIntegration

type
typing.Literal[Any]
default:"integration/vcs/gitlab"
required
name
str
required
account_name
str
required
Account 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>.

GitlabProviderAccount

type
typing.Literal[Any]
default:"provider-account/gitlab"
required
name
str
required
integrations
typing.List[GitlabIntegration]
required
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

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
The repository URL.
ref
str
required
The commit SHA.
branch_name
typing.Optional[str]
Selecting branch will select latest commit SHA of the branch.

GlobalSettings

type
typing.Literal[Any]
default:"gateway-global-settings"
required
retry_settings
typing.Optional[RetryConfig]
logging_settings
typing.Optional[LoggingMode]
semantic_cache_settings
typing.Optional[SemanticCacheSettings]

GluonFramework

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

GoogleGeminiProviderAccount

type
typing.Literal[Any]
default:"provider-account/google-gemini"
required
name
str
required
The name of the Google Gemini provider account
auth_data
GcpApiKeyAuth
required
integrations
typing.List[GeminiModel]
required
πŸ”— GeminiModelList 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
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

GoogleModelArmorApiKeyAuth

type
typing.Literal[Any]
default:"api-key"
required
api_key
str
required
Google Cloud API key with Model Armor access

GoogleModelArmorGuardrailConfig

name
str
required
The name of the Guardrail Config.
description
typing.Optional[str]
Optional description for this Guardrail Config.
type
typing.Literal[Any]
default:"integration/guardrail-config/google-model-armor"
required
auth_data
GoogleModelArmorGuardrailConfigAuthData
required
πŸ”— GoogleModelArmorGuardrailConfigAuthDataAuthentication credentials for Google Cloud Model Armor
operation
GoogleModelArmorGuardrailConfigOperation
required
πŸ”— GoogleModelArmorGuardrailConfigOperationThe operation type to use for the Guardrail. Validate guardrails are used to validate requests and mutate can validate as well as mutate requests.
priority
typing.Optional[int]
default:"1"
Execution order for mutate guardrails. Lower values run first. Only applicable when operation is mutate.
enforcing_strategy
EnforcingStrategy
required
config
GoogleModelArmorGuardrailConfigConfig
required

GoogleModelArmorGuardrailConfigAuthData

Union, One Of:

GoogleModelArmorGuardrailConfigConfig

project_id
str
required
The Google Cloud project ID where Model Armor is enabled
location
GcpRegion
required
template_id
str
required
The Model Armor template name that defines which filters and confidence thresholds to apply (e.g. my-template)

GoogleModelArmorKeyFileAuth

type
typing.Literal[Any]
default:"key-file"
required
key_file_content
GoogleModelArmorKeyFileAuthKeyFileContent
required
πŸ”— GoogleModelArmorKeyFileAuthKeyFileContentThe JSON content of your Google Cloud service account key file with Model Armor permissions

GoogleModelArmorKeyFileAuthKeyFileContent

Union, One Of:

GoogleVertexProviderAccount

type
typing.Literal[Any]
default:"provider-account/google-vertex"
required
name
str
required
The name of the Google Vertex provider account
project_id
str
required
The Google Cloud project ID where Vertex AI is enabled
region
VertexRegion
required
auth_data
typing.Optional[GoogleVertexProviderAccountAuthData]
πŸ”— GoogleVertexProviderAccountAuthDataService account key JSON, or Workload Identity Federation file (workload-identity-federation-file) with external_account JSON (e.g. create-cred-config). https://docs.truefoundry.com/gateway/google-vertex
integrations
typing.List[VertexModel]
required
πŸ”— VertexModelList 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
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

GoogleVertexProviderAccountAuthData

Union, One Of:

Graph

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

GraySwanCygnalApiKeyAuth

type
typing.Literal[Any]
default:"api-key"
required
api_key
str
required
GraySwan API key for Cygnal access

GraySwanCygnalGuardrailConfig

name
str
required
The name of the Guardrail Config.
description
typing.Optional[str]
Optional description for this Guardrail Config.
type
typing.Literal[Any]
default:"integration/guardrail-config/grayswan-cygnal"
required
auth_data
GraySwanCygnalApiKeyAuth
required
operation
typing.Literal[Any]
default:"validate"
required
The operation type for this guardrail. GraySwan Cygnal guardrails can only be used for validation.
enforcing_strategy
EnforcingStrategy
required
config
GraySwanCygnalGuardrailConfigConfig
required

GraySwanCygnalGuardrailConfigConfig

base_url
typing.Optional[str]
Optional override for the Cygnal monitor endpoint. Defaults to https://api.grayswan.ai/cygnal/monitor if not provided.
policy_ids
typing.Optional[typing.List[str]]
Custom policy IDs to use for monitoring. Rules from all policies are merged in order, with earlier policies taking precedence. If not provided, the default Basic Content Safety policy is applied, refer to Docs
rules
typing.Optional[typing.Dict[(str, str)]]
Custom rule definitions for monitoring. Each key is a rule name and its value is the rule description, refer to Docs
reasoning_mode
GraySwanCygnalGuardrailConfigConfigReasoningMode
required
πŸ”— GraySwanCygnalGuardrailConfigConfigReasoningModeControls whether Cygnal uses internal reasoning steps before determining if content violates policy. β€œoff” is fastest, β€œhybrid” adds moderate reasoning, β€œthinking” performs guided reasoning for highest quality.

GroqKeyAuth

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

GroqModel

type
typing.Literal[Any]
default:"integration/model/groq"
required
name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The Groq model identifier (e.g., llama-3.1-8b-instant, openai/gpt-oss-20b). This is the standard model id from Groq’s model catalog.
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
The name of the Groq provider account
auth_data
GroqKeyAuth
required
integrations
typing.List[GroqIntegrations]
required
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
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

GuardrailConfigGroup

type
typing.Literal[Any]
default:"provider-account/guardrail-config-group"
required
name
str
required
The name of the Guardrail Config Group.
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.
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

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

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
llm_input_guardrails
typing.List[str]
required
Guardrail selectors of the guardrails to apply to the input (format: groupName/guardrailName)
llm_output_guardrails
typing.List[str]
required
Guardrail selectors of the guardrails to apply to the output (format: groupName/guardrailName)
mcp_tool_pre_invoke_guardrails
typing.List[str]
required
Guardrail selectors of the guardrails to apply to the MCP tool pre invoke (format: groupName/guardrailName)
mcp_tool_post_invoke_guardrails
typing.List[str]
required
Guardrail selectors of the guardrails to apply to the MCP tool post invoke (format: groupName/guardrailName)

GuardrailsWhen

target
typing.Optional[TargetConditionGroup]
subjects
typing.Optional[SubjectConditionGroup]
metadata
typing.Optional[typing.Dict[(str, str)]]

H2OFramework

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

HashicorpAppRoleAuth

type
typing.Literal[Any]
default:"approle"
required
role_id
str
required
AppRole role ID for Vault authentication.
secret_id
str
required
AppRole secret ID for Vault authentication.

HashicorpProviderAccount

type
typing.Literal[Any]
default:"provider-account/hashicorp"
required
name
str
required
The name of the HashiCorp Vault provider account.
integrations
typing.List[HashicorpIntegrations]
required
List of integrations that are associated with the HashiCorp Vault provider account.
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

HashicorpTokenAuth

type
typing.Literal[Any]
default:"token"
required
token
str
required
Vault authentication token that you want to use for authentication.

HashicorpVaultIntegration

type
typing.Literal[Any]
default:"integration/secret-store/hashicorp/vault"
required
name
str
required
The name of the integration that will be displayed in the TrueFoundry UI.
vault_url
str
required
The URL of the HashiCorp Vault server (e.g., https://vault.example.com:8200).
kv_mount_path
str
required
Mount path of the KV v2 engine vault to use for secrets.
root_path
typing.Optional[str]
auth_data
HashicorpVaultIntegrationAuthData
required
πŸ”— HashicorpVaultIntegrationAuthDataAuthentication data for the Vault 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>.
namespace
typing.Optional[str]
Namespace for vault operations, used for multi-tenancy in HashiCorp Vault Enterprise. Optional for open source Vault.

HashicorpVaultIntegrationAuthData

Union, One Of:

HeaderMatch

type
typing.Literal[Any]
default:"header"
required
name
str
required
Header name to match on
exact_match
str
required
Header value to match on

HeaderRoutingConfig

Union, One Of:

HeadersOverride

remove
typing.Optional[typing.List[str]]
List of headers to remove from upstream request
set_
typing_extensions.Annotated[(typing.Optional[typing.Dict[(str, str)]], Any, Any)]

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
Name of the Helm deployment. This will be set as the release name of the chart you are deploying.
labels
typing.Optional[typing.Dict[(str, str)]]
Add labels to base argo app
source
HelmSource
required
πŸ”— HelmSourceSource helm repository
values
typing.Optional[typing.Dict[(str, typing.Any)]]
Values file as block file
kustomize
typing.Optional[Kustomize]
ignore_differences
typing_extensions.Annotated[(typing.Optional[typing.List[typing.Dict[(str, typing.Any)]]], Any, Any)]
workspace_fqn
typing.Optional[str]
Fully qualified name of the workspace

HelmRepo

type
typing.Literal[Any]
default:"helm-repo"
required
repo_url
str
required
Helm repository URL - 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:

HostedA2AAgent

type
typing.Literal[Any]
default:"hosted-a2a-agent"
required
Type of agent source
agent_card_url
str
required
Agent Card URL for the A2A Agent
headers
typing.Optional[typing.Dict[(str, str)]]
Headers to be sent with the request to the hosted A2A agent. Primarily used for authentication.

HttpError

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

HttpErrorCode

Union, One Of:

HttpProbe

type
typing.Literal[Any]
default:"http"
required
Request Type
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.Any)]]
old_value
typing_extensions.Annotated[(typing.Optional[typing.Dict[(str, typing.Any)]], 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
ImageContentPartImageUrl
required
πŸ”— ImageContentPartImageUrlImage URL linking to the image

ImageContentPartImageUrl

url
ImageContentPartImageUrlUrl
required
πŸ”— ImageContentPartImageUrlUrlImage URL linking to the image
detail
typing.Optional[str]
Details

ImageContentPartImageUrlUrl

Union, One Of:

InfraProviderAccount

Union, One Of:

IngressControllerConfig

ingress_class_name
str
default:"nginx"
required
Ingress Class Name
tls_enabled
typing.Optional[bool]
Whether TLS is managed by the ingress controller. If enabled, the ingress object will have TLS configuration.

InlineSpecSource

type
typing.Literal[Any]
default:"inline"
required
openapi_spec
InlineSpecSourceOpenapiSpec
required
πŸ”— InlineSpecSourceOpenapiSpecThe OpenAPI specification as a JSON object or a JSON/YAML string.

InlineSpecSourceOpenapiSpec

Union, One Of:

InNotInOperator

condition
InNotInOperatorCondition
required
values
typing.List[str]
required

InputOutputBasedCostMetricValue

input
NonNegativeFloat
required
output
NonNegativeFloat
required
cache_read
typing.Optional[NonNegativeFloat]
cache_write
typing.Optional[NonNegativeFloat]
input_tiers
typing.Optional[typing.List[PrivatePricingTier]]
πŸ”— PrivatePricingTierOptional volume-based pricing tiers for input tokens. Tokens up to the first tier use base rate above.
output_tiers
typing.Optional[typing.List[PrivatePricingTier]]
πŸ”— PrivatePricingTierOptional volume-based pricing tiers for output tokens. Tokens up to the first tier use base rate above.
cache_read_tiers
typing.Optional[typing.List[PrivatePricingTier]]
πŸ”— PrivatePricingTierOptional volume-based pricing tiers for cache read tokens. Tokens up to the first tier use base rate above.
cache_write_tiers
typing.Optional[typing.List[PrivatePricingTier]]
πŸ”— PrivatePricingTierOptional volume-based pricing tiers for cache write tokens. Tokens up to the first tier use base rate above.

Intercept

type
typing.Literal[Any]
default:"intercept"
required
name
str
required
Name of the service this intercept is for
rules
typing.List[InterceptRulesItem]
required

InterceptRulesItem

port
int
required
Port of service to be intercepted
match
typing.Optional[HeaderMatch]
action
InterceptRulesItemAction
required
πŸ”— InterceptRulesItemActionAction to take on succesful match

InterceptRulesItemAction

Union, One Of:

InternalArtifactVersion

id
str
required
Unique identifier for the artifact version
fqn
str
required
Fully qualified name of the artifact version in the format β€˜{artifact_type}:{tenant_name}/{ml_repo_name}/{artifact_name}:{version}’
created_by_subject
Subject
required
πŸ”— SubjectSubject (user, team, or service account) that created this artifact version
created_at
typing.Optional[dt.datetime]
Timestamp when the artifact version was created
updated_at
typing.Optional[dt.datetime]
Timestamp when the artifact version was last updated
manifest
ArtifactManifest
required
πŸ”— ArtifactManifestManifest containing metadata for a generic artifact version
ml_repo_id
str
required
ID of the ML Repo that this artifact version belongs to
tags
typing.Optional[typing.List[str]]
List of tags associated with this artifact version for filtering and organization
version_alias
typing.Optional[str]
Optional human-readable version alias (e.g. v1.0.0)
usage_code_snippet
typing.Optional[str]
Code snippet demonstrating how to use this artifact version
artifact_id
str
required
ID of the parent artifact that this version belongs to
artifact_fqn
str
required
Fully qualified name of the parent artifact (internal use only)
artifact_size
typing.Optional[int]
Total size of the artifact version in bytes (internal use only)

InternalListArtifactVersionsResponse

data
typing.List[InternalListArtifactVersionsResponseDataItem]
required
πŸ”— InternalListArtifactVersionsResponseDataItemList of artifact versions and model versions with internal metadata
pagination
Pagination
required
πŸ”— PaginationPagination information including total count, offset, and limit

InternalListArtifactVersionsResponseDataItem

Union, One Of:

InternalModelVersion

id
str
required
Unique identifier for the artifact version
fqn
str
required
Fully qualified name of the artifact version in the format β€˜{artifact_type}:{tenant_name}/{ml_repo_name}/{artifact_name}:{version}’
created_by_subject
Subject
required
πŸ”— SubjectSubject (user, team, or service account) that created this artifact version
created_at
typing.Optional[dt.datetime]
Timestamp when the artifact version was created
updated_at
typing.Optional[dt.datetime]
Timestamp when the artifact version was last updated
manifest
ModelManifest
required
πŸ”— ModelManifestManifest containing metadata specific to the model version
ml_repo_id
str
required
ID of the ML Repo that this artifact version belongs to
tags
typing.Optional[typing.List[str]]
List of tags associated with this artifact version for filtering and organization
version_alias
typing.Optional[str]
Optional human-readable version alias (e.g. v1.0.0)
usage_code_snippet
typing.Optional[str]
Code snippet demonstrating how to use this artifact version
model_id
str
required
ID of the parent model that this version belongs to
metrics
typing.Optional[typing.List[Metric]]
πŸ”— MetricList of metrics associated with this model version
deployable
typing.Optional[bool]
Whether this model version is ready for deployment
artifact_fqn
str
required
Fully qualified name of the parent model (internal use only)
artifact_size
typing.Optional[int]
Total size of the model version in bytes (internal use only)

InviteUserResponse

IsClusterConnectedResponse

is_connected
typing_extensions.Annotated[(bool, Any, Any)]
required

JfrogArtifactsRegistry

type
typing.Literal[Any]
default:"integration/docker-registry/jfrog"
required
name
str
required
The name of the integration that will be displayed in the TrueFoundry UI.
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
The name of the provider account.
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.
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

Job

type
typing.Literal[Any]
default:"job"
required
name
str
required
Name of the job
image
JobImage
required
πŸ”— JobImageSpecify whether you want to deploy a Docker image or build and deploy from source code
trigger
JobTrigger
required
πŸ”— JobTriggerSpecify the trigger
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)]]
Labels
kustomize
typing.Optional[Kustomize]
workspace_fqn
typing.Optional[str]
Fully qualified name of the workspace

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

id
str
required
JobRun ID
name
str
required
JobRun Name
application_name
typing_extensions.Annotated[(str, Any, Any)]
required
deployment_version
typing_extensions.Annotated[(str, Any, Any)]
required
created_at
typing_extensions.Annotated[(float, Any, Any)]
required
end_time
typing_extensions.Annotated[(typing.Optional[float], Any, Any)]
duration
typing.Optional[int]
Duration of JobRun
command
str
required
Command
total_retries
typing_extensions.Annotated[(int, Any, Any)]
required
error
typing.Optional[str]
Error
status
JobRunStatus
required
πŸ”— JobRunStatusStatus of JobRun
triggered_by
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
triggered_by_subject
typing_extensions.Annotated[(typing.Optional[Subject], Any, Any)]
exit_code
typing_extensions.Annotated[(typing.Optional[int], Any, Any)]
spark_ui
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
application_id
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
deployment_id
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
tenant_name
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]

JobTrigger

Union, One Of:

JobTriggerInput

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

JobTriggerInputCommand

Union, One Of:

JsonObjectResponseFormat

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

JsonSchema

name
str
required
Name of the schema
schema_
typing_extensions.Annotated[(typing.Dict[(str, typing.Any)], Any, Any)]
required

JsonSchemaResponseFormat

type
typing.Literal[Any]
default:"json_schema"
required
json_schema
JsonSchema
required

Jwt

id
str
required
subject_type
typing_extensions.Annotated[(str, Any, Any)]
required
subject_id
typing_extensions.Annotated[(str, Any, Any)]
required
metadata
typing.Optional[typing.Dict[(str, typing.Any)]]
expiry
dt.datetime
required
created_at
typing_extensions.Annotated[(dt.datetime, Any, Any)]
required
updated_at
typing_extensions.Annotated[(dt.datetime, Any, Any)]
required

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

Kustomize

patch
typing.Optional[typing.Dict[(str, 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.Any)]]]
Additional kubernetes manifests to be included in the application

LatencyBasedLoadBalanceTarget

target
str
required
Target model or provider FQN
retry_config
typing.Optional[RetryConfig]
fallback_status_codes
typing.Optional[typing.List[str]]
Status Codes for which the request will fallback to other targets. If the status code is not present in fallback_status_codes, it fails immediately.
fallback_candidate
typing.Optional[bool]
Whether this target is a fallback candidate. If set to false, this model will not be considered as a fallback option for targets of this load-balance-rule
override_params
typing.Optional[typing.Dict[(str, typing.Any)]]
Optional parameters to override in the request
headers_override
typing.Optional[HeadersOverride]
metadata_match
typing.Optional[typing.Dict[(str, str)]]
Optional metadata key-value pairs that must match incoming request metadata headers for this target to be considered for routing.

LatencyBasedLoadBalancing

type
typing.Literal[Any]
default:"latency-based-routing"
required
load_balance_targets
typing.List[LatencyBasedLoadBalanceTarget]
required
πŸ”— LatencyBasedLoadBalanceTargetList of targets for latency-based load balancing

LatencyBasedLoadBalancingRule

id
str
required
Unique identifier for the rule
when
LoadBalancingWhen
required

LegacyAgentManifest

type
typing.Literal[Any]
default:"agent"
required
Type of the manifest
name
str
required
The name of the Agent
description
str
required
The description of the Agent
source
AgentSource
required
collaborators
typing.List[Collaborator]
required
πŸ”— CollaboratorList of users who have access to this Agent
sample_inputs
typing.Optional[typing.List[SampleAgentInput]]
πŸ”— SampleAgentInputSample inputs for your agent. These inputs are shown as an example in the β€œAgent Chat” page. (Click on Try Now in the agent listing page)
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

LightGbmFramework

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

ListAgentSkillsResponse

data
typing.List[AgentSkill]
required
πŸ”— AgentSkillList of agent skills matching the query
pagination
Pagination
required
πŸ”— PaginationPagination information

ListAgentSkillVersionsResponse

data
typing.List[AgentSkillVersion]
required
πŸ”— AgentSkillVersionList of agent skill versions
pagination
Pagination
required
πŸ”— PaginationPagination information

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
πŸ”— ArtifactList of artifacts matching the query
pagination
Pagination
required
πŸ”— PaginationPagination information including total count, offset, and limit

ListArtifactVersionsResponse

data
typing.List[ArtifactVersion]
required
πŸ”— ArtifactVersionList of artifact versions matching the query
pagination
Pagination
required
πŸ”— PaginationPagination information including total count, offset, and limit

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
πŸ”— DataDirectoryList of data directories matching the query
pagination
Pagination
required
πŸ”— PaginationPagination information including total count, offset, and limit

ListEnvironmentsResponse

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

ListFilesRequest

id
str
required
ID of the artifact version to list files from
path
typing.Optional[str]
Relative path within the artifact version to list files from (defaults to root)
limit
typing.Optional[int]
Maximum number of files/directories to return
page_token
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]

ListFilesResponse

data
typing.List[FileInfo]
required
πŸ”— FileInfoList of files and directories in the artifact version
pagination
TokenPagination
required
πŸ”— TokenPaginationPagination information including page tokens for navigation

ListJobRunResponse

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

ListMlReposResponse

data
typing.List[MlRepo]
required
πŸ”— MlRepoList of ML Repos matching the query
pagination
Pagination
required
πŸ”— PaginationPagination information including total count, offset, and limit

ListModelsResponse

data
typing.List[Model]
required
πŸ”— ModelList of models matching the query
pagination
Pagination
required
πŸ”— PaginationPagination information including total count, offset, and limit

ListModelVersionsResponse

data
typing.List[ModelVersion]
required
πŸ”— ModelVersionList of model versions matching the query
pagination
Pagination
required
πŸ”— PaginationPagination information including total count, offset, and limit

ListPersonalAccessTokenResponse

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

ListPromptsResponse

data
typing.List[Prompt]
required
πŸ”— PromptList of prompts matching the query
pagination
Pagination
required
πŸ”— PaginationPagination information including total count, offset, and limit

ListPromptVersionsResponse

data
typing.List[PromptVersion]
required
πŸ”— PromptVersionList of prompt versions matching the query
pagination
Pagination
required
πŸ”— PaginationPagination information including total count, offset, and limit

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)
retry_config
typing.Optional[RetryConfig]
fallback_status_codes
typing.Optional[typing.List[str]]
Status Codes for which the request will fallback to other targets. If the status code is not present in fallback_status_codes, it fails immediately.
fallback_candidate
typing.Optional[bool]
Whether this target is a fallback candidate. If set to false, this model will not be considered as a fallback option for targets of this load-balance-rule
override_params
typing.Optional[typing.Dict[(str, typing.Any)]]
Optional parameters to override in the request
headers_override
typing.Optional[HeadersOverride]
metadata_match
typing.Optional[typing.Dict[(str, str)]]
Optional metadata key-value pairs that must match incoming request metadata headers for this target to be considered for routing.

LoadBalancingConfig

type
typing.Literal[Any]
default:"gateway-load-balancing-config"
required
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.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

LocalArtifactSource

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

LocalModelSource

type
typing.Literal[Any]
default:"local"
required
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, Any)]

LoggingConfig

enabled
bool
required
Whether logging is enabled for the chat prompt
tracing_project_fqn
typing.Optional[str]
The FQN of the tracing project where the logs will be stored

LoggingMode

Union, One Of:

LoggingModeAlways

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

LoggingModeHeaderControlled

type
typing.Literal[Any]
default:"header_controlled"
required
log_body_by_default
bool
required
Sets the default body logging behaviour when no header is present. Enabling it will log requests by default and clients can opt out. Disabling it will NOT log by default and clients can opt in to log requests.

LoggingModeNever

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

LogsFilterQuery

match_string
typing_extensions.Annotated[(str, Any, Any)]
required
type
LogsFilterQueryType
required
πŸ”— LogsFilterQueryTypequery filter type, regex or substring
operator
LogsSearchOperatorType
required
πŸ”— LogsSearchOperatorTypeComparison operator for filter. equal or not_equal

LogsResponse

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

Manual

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

McpServerAuth

Union, One Of:

McpServerEnvAuth

type
typing.Literal[Any]
default:"env"
required
env
typing.Dict[(str, str)]
required
Map each env variable to its value. For shared, enter the actual value. For individual, use a placeholder that will be filled in by each user (e.g. API_KEY {{API_KEY}}).
auth_level
typing.Optional[McpServerEnvAuthAuthLevel]
πŸ”— McpServerEnvAuthAuthLevelLevel at which this authentication will be applied. Values: global (default), per_user

McpServerHeaderAuth

type
typing.Literal[Any]
default:"header"
required
headers
typing.Dict[(str, str)]
required
Map each header name to its value. For shared, enter the actual value. For individual, use a placeholder that will be filled in by each user (e.g. Bearer {{API_KEY}}).
auth_level
McpServerHeaderAuthAuthLevel
required
πŸ”— McpServerHeaderAuthAuthLevelLevel at which this authentication will be applied. Values: global (default), per_user

McpServerHeaderOverrideAuth

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

McpServerIntegration

type
typing.Literal[Any]
default:"integration/mcp-server/remote"
required
name
str
required
The name of the MCP Server.
description
str
required
Provide a brief description of the purpose of this MCP Server.
url
str
required
The endpoint URL for the MCP Server.
transport
McpServerIntegrationTransport
required
πŸ”— McpServerIntegrationTransportThe transport protocol to use for communication with the MCP Server.
auth_data
typing.Optional[McpServerAuth]
authorized_subjects
typing.Optional[typing.List[str]]
List of teams/users who can use this MCP server.

McpServerIntegrations

Union, One Of:

McpServerManifest

Union, One Of:

McpServerOAuth2

type
typing.Literal[Any]
default:"oauth2"
required
OAuth2 authentication
grant_type
McpServerOAuth2GrantType
required
πŸ”— McpServerOAuth2GrantTypeThe OAuth2 grant type to use for authentication.
authorization_url
typing.Optional[str]
URL for the authorization request
token_url
str
required
The endpoint to exchange auth code for tokens.
client_id
typing.Optional[str]
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.
registration_url
typing.Optional[str]
URL for dynamic client registration (RFC 7591). If provided, client credentials will be obtained automatically using the Dynamic Client Registration (DCR) process.
code_challenge_methods_supported
typing.Optional[typing.List[typing.Literal[Any]]]
List of supported PKCE code challenge methods (S256 only)
jwt_source
McpServerOAuth2JwtSource
required
πŸ”— McpServerOAuth2JwtSourceSource of the JWT token to be used for verification.
scopes
typing.Optional[typing.List[str]]
List of scopes to request from the OAuth2 provider.

McpServerPassthrough

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

McpServerProviderAccount

type
typing.Literal[Any]
default:"provider-account/mcp-server-group"
required
name
str
required
The name of the MCP Server Group.
collaborators
typing.List[Collaborator]
required
πŸ”— CollaboratorList of teams/users who can manage this MCP Server Group. These subjects can add new MCP server integrations, can edit existing ones and can also use the MCP server.
integrations
typing.List[McpServerIntegrations]
required
πŸ”— McpServerIntegrationsList of MCP Servers, which are part of this MCP Server Group.
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

McpServerSource

name
str
required
Name of the MCP server
enabled_tools
typing.Optional[typing.List[str]]
List of tools to enable from this source server.
auth_data
typing.Optional[McpServerHeaderOverrideAuth]

McpServerToolDetails

mcp_server_integration_id
str
required
The integration ID of the MCP server
tool_name
str
required
The name of the tool in the MCP server

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
bool
required
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
bool
required
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

McpToolSetting

name
str
required
The unique name of the tool.
description
typing.Optional[str]
Describe what this tool does. This helps AI models understand when to use it.
disabled
typing.Optional[bool]
Allows to disable the tool.

McpToolsOperator

condition
McpToolsOperatorCondition
required
values
typing.List[McpToolTarget]
required

McpToolTarget

name
str
required
Name of the MCP server
enable_all_tools
bool
required
When enabled, all tools from this MCP server are targeted. Disable to select specific tools.
enabled_tools
typing.Optional[typing.List[str]]
List of specific tools to target from this MCP server.

Metadata

job_run_name_alias
typing.Optional[str]
Job Run Name Alias

Metric

key
str
required
Name of the metric
value
typing.Optional[float]
Value of the metric
timestamp
typing.Optional[int]
Timestamp when the metric was recorded (epoch milliseconds)
step
typing.Optional[int]
Training step number when the metric was recorded

MirrorAction

type
typing.Literal[Any]
default:"mirror"
required
service_uri
str
required
Service uri to mirror to. This is the kubernetes fully qualified domain name that the target service can be reached on Eg - For a service called sample-service in workspace ws this would be `sample-service.ws.svc.cluster.local
port
int
required
Port to redirect the service traffic to
percentage
int
required
Percentage of requests to mirror

MistralAiKeyAuth

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

MistralAiModel

type
typing.Literal[Any]
default:"integration/model/mistral-ai"
required
name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The Mistral AI model identifier (e.g., mistral-medium-2312, ministral-8b-2410). This is the API Endpoint name from Mistral AI’s model catalog.
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
The name of the Mistral AI provider account
auth_data
MistralAiKeyAuth
required
integrations
typing.List[MistralAiIntegrations]
required
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
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

MlRepo

tenant_name
str
required
Tenant Name
manifest
MlRepoManifest
required
created_by_subject
Subject
required
created_at
dt.datetime
required
Created At
account_id
str
required
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
Name of the ML Repo.
description
typing.Optional[str]
Description for the ML Repo.
storage_integration_fqn
str
required
Storage Integration to store artifacts and models. A storage integration represents a connected blob storage like AWS S3 / Azure Blob Storage / Google Cloud Storage.
collaborators
typing.List[Collaborator]
required
πŸ”— CollaboratorUsers and Teams that have access to MLRepo
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

Model

id
str
required
Unique identifier for the artifact
ml_repo_id
str
required
ID of the ML Repo that this artifact belongs to
type
typing.Optional[typing.Literal[Any]]
Type of the artifact, always β€˜model’ for Model entities
name
str
required
Name of the artifact (alphanumeric characters, hyphens, and underscores only, max 256 characters)
fqn
str
required
Fully qualified name of the artifact in the format β€˜{artifact_type}:{tenant_name}/{ml_repo_name}/{artifact_name}’
created_by_subject
Subject
required
πŸ”— SubjectSubject (user, team, or service account) that created this artifact
created_at
typing.Optional[dt.datetime]
Timestamp when the artifact was created
updated_at
typing.Optional[dt.datetime]
Timestamp when the artifact was last updated
latest_version
typing.Optional[ModelVersion]
πŸ”— ModelVersionThe most recent version of this model
run_steps
typing.Optional[typing.List[int]]
List of run step numbers where this artifact was created or updated

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.Any)]]
Arbitrary extra parameters to pass to the model when generating

ModelCostMetric

Union, One Of:

ModelManifest

name
str
required
Name of the model (alphanumeric characters, hyphens, and underscores only, max 256 characters)
metadata
typing.Dict[(str, typing.Any)]
required
Key value metadata. Should be valid JSON. For e.g. \{"business-unit": "sales", "quality": "good", "rating": 4.5\}
ml_repo
str
required
Name of the ML Repo that this model belongs to (must start and end with alphanumeric, 2-100 characters)
version
typing.Optional[int]
Version of the entity
type
typing.Literal[Any]
default:"model-version"
required
description
typing.Optional[str]
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)
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
Unique identifier for the artifact version
fqn
str
required
Fully qualified name of the artifact version in the format β€˜{artifact_type}:{tenant_name}/{ml_repo_name}/{artifact_name}:{version}’
created_by_subject
Subject
required
πŸ”— SubjectSubject (user, team, or service account) that created this artifact version
created_at
typing.Optional[dt.datetime]
Timestamp when the artifact version was created
updated_at
typing.Optional[dt.datetime]
Timestamp when the artifact version was last updated
manifest
ModelManifest
required
πŸ”— ModelManifestManifest containing metadata specific to the model version
ml_repo_id
str
required
ID of the ML Repo that this artifact version belongs to
tags
typing.Optional[typing.List[str]]
List of tags associated with this artifact version for filtering and organization
version_alias
typing.Optional[str]
Optional human-readable version alias (e.g. v1.0.0)
usage_code_snippet
typing.Optional[str]
Code snippet demonstrating how to use this artifact version
model_id
str
required
ID of the parent model that this version belongs to
metrics
typing.Optional[typing.List[Metric]]
πŸ”— MetricList of metrics associated with this model version
deployable
typing.Optional[bool]
Whether this model version is ready for deployment

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
πŸ”— MultiPartUploadStorageProviderStorage provider being used for the multipart upload (e.g., β€˜S3_COMPATIBLE’ or β€˜AZURE_BLOB’)
part_signed_urls
typing.List[SignedUrl]
required
πŸ”— SignedUrlList of signed URLs for each part of the multipart upload
s3compatible_upload_id
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
azure_blob_block_ids
typing.Optional[typing.List[str]]
List of block IDs for Azure Blob Storage multipart upload
finalize_signed_url
SignedUrl
required
πŸ”— SignedUrlSigned URL to call after all parts are uploaded to finalize the multipart upload

MultiPartUploadResponse

data
MultiPartUpload
required
πŸ”— MultiPartUploadMultipart upload information including signed URLs for each part

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
Root subject of input NATS
consumer_name
str
required
Consumer name of input NATS
wait_time_seconds
int
default:"19"
required
Wait timeout for long polling.
nats_metrics_url
typing.Optional[str]
URL for the NATS metrics endpoint. It is compulsory if you want to use NATS autoscaling.
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
Root subject of output NATS
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
The API key for Nomic authentication

NomicModel

type
typing.Literal[Any]
default:"integration/model/nomic"
required
name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The name of the Nomic model to use
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
The name of the Nomic provider account
auth_data
NomicKeyAuth
required
integrations
typing.List[NomicIntegrations]
required
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
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

Notebook

type
typing.Literal[Any]
default:"notebook"
required
image
WorkbenchImage
required
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
The base domain for the cluster with which you can access your Notebooks

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 A30 - [1g.6gb, 2g.12gb, 4g.24gb] A100 40 GB - [1g.5gb, 1g.10gb, 2g.10gb, 3g.20gb, 4g.20gb, 7g.40gb] A100 80 GB / H100 80 GB - [1g.10gb, 1g.20gb, 2g.20gb, 3g.40gb, 4g.40gb, 7g.80gb] H100 94 GB - [1g.12gb, 1g.24gb, 2g.24gb, 3g.47gb, 4g.47gb, 7g.94gb] H100 96 GB - [1g.12gb, 1g.24gb, 2g.24gb, 3g.48gb, 4g.48gb, 7g.96gb] H200 141 GB - [1g.18gb, 1g.35gb, 2g.35gb, 3g.71gb, 4g.71gb] B200 180 GB - [1g.23gb, 1g.45gb, 2g.45gb, 3g.90gb, 4g.90gb, 7g.180gb]

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.Literal[Any]
default:"oauth2"
required

OciRepo

type
typing.Literal[Any]
default:"oci-repo"
required
oci_chart_url
str
required
OCI chart URL - 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
The custom host URL for Ollama API

OllamaModel

type
typing.Literal[Any]
default:"integration/model/ollama"
required
name
str
required
Name to identify this Ollama model in the UI
model_id
str
required
The name of the Ollama model to use
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
The name of the Ollama provider account
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
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

OnnxFramework

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

OpaAuth

Union, One Of:

OpaBearerAuth

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

OpaGuardrailConfig

name
str
required
The name of the Guardrail Config.
description
typing.Optional[str]
Optional description for this Guardrail Config.
type
typing.Literal[Any]
default:"integration/guardrail-config/opa"
required
auth_data
typing.Optional[OpaAuth]
operation
typing.Literal[Any]
default:"validate"
required
The operation type for this guardrail. OPA guardrails can only be used for validation.
enforcing_strategy
EnforcingStrategy
required
config
OpaGuardrailConfigConfig
required

OpaGuardrailConfigConfig

opa_url
str
required
The base URL of the OPA server (e.g., https://opa.example.com:8181). The policy will be queried at {opa_url}/v1/data/{policy_path}.
policy_path
str
required
The policy path to evaluate in OPA (e.g., β€œauthz/allow”, β€œguardrails/validate”). This corresponds to the package and rule name in your Rego policy. The full query URL will be {opa_url}/v1/data/{policy_path}.

OpaHeaderAuth

type
typing.Literal[Any]
default:"header"
required
headers
typing.Dict[(str, str)]
required
Custom headers to include in requests to OPA server (e.g., {β€œAuthorization”: β€œBearer <token>”, β€œX-API-Key”: β€œ<key>”})

OpenaiApiKeyAuth

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

OpenAiModel

type
typing.Literal[Any]
default:"integration/model/openai"
required
name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The OpenAI model identifier (e.g., gpt-4o, gpt-4-turbo, gpt-3.5-turbo, o1-mini). This is the standard model name from OpenAI’s API documentation.
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
The name of the Guardrail Config.
description
typing.Optional[str]
Optional description for this Guardrail Config.
type
typing.Literal[Any]
default:"integration/guardrail-config/openai-moderations"
required
auth_data
OpenaiApiKeyAuth
required
operation
typing.Literal[Any]
default:"validate"
required
The operation type for this guardrail. OpenAI Moderation guardrails can only be used for validation.
enforcing_strategy
EnforcingStrategy
required
config
OpenAiModerationsGuardrailConfigConfig
required

OpenAiModerationsGuardrailConfigConfig

model
str
default:"omni-moderation-latest"
required
The model to use for the OpenAI Moderation API.
base_url
typing.Optional[str]
Optional custom base URL for OpenAI API. If not provided, the default base URL will be used.
category_thresholds
typing.Optional[typing.Dict[(str, float)]]

OpenaiProviderAccount

type
typing.Literal[Any]
default:"provider-account/openai"
required
name
str
required
The name of the OpenAI provider account
auth_data
OpenaiApiKeyAuth
required
base_url
typing.Optional[str]
Optional custom base URL for OpenAI API
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
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

OpenApimcpServerManifest

type
typing.Literal[Any]
default:"mcp-server/openapi"
required
name
str
required
The name of the OpenAPI MCP Server.
description
str
required
Provide a brief description of the purpose of this OpenAPI MCP Server.
url
str
required
The base URL where API requests will be sent. This should be the root endpoint of your API server, without any path suffix.
openapi_spec_source
OpenApiSpecSource
required
tls_settings
typing.Optional[CustomTlsSettings]
enable_all_tools
typing.Optional[bool]
When enabled, all tools from the OpenAPI spec will be available (up to 30 tools). Disable to select specific tools.
tool_settings
typing.Optional[typing.List[OpenApimcpToolSetting]]
πŸ”— OpenApimcpToolSettingThe tools to customize from the OpenAPI Server.
auth_data
typing.Optional[McpServerAuth]
collaborators
typing.List[Collaborator]
required
πŸ”— CollaboratorUsers and Teams that have access to this OpenAPI Server
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]
tags
typing.Optional[typing.Dict[(str, typing.Any)]]
Key-value pairs to categorize this OpenAPI MCP Server (e.g., by owner or environment).

OpenApimcpToolSetting

method
OpenApimcpToolSettingMethod
required
πŸ”— OpenApimcpToolSettingMethodThe HTTP method for this endpoint.
path
str
required
The API endpoint path (e.g., /users/{id}).
name
str
required
The unique name of this tool, derived from OpenAPI operationId.
description
str
required
Describe what this tool does. This helps AI models understand when to use it.

OpenApiSpecSource

Union, One Of:

OpenRouterApiKeyAuth

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

OpenRouterModel

type
typing.Literal[Any]
default:"integration/model/openrouter"
required
name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The OpenRouter model identifier (e.g., anthropic/claude-3-haiku, openai/gpt-4o-mini). This is the model name from OpenRouter’s model catalog.
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the OpenRouter 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>.

OpenRouterProviderAccount

type
typing.Literal[Any]
default:"provider-account/openrouter"
required
name
str
required
The name of the OpenRouter provider account
auth_data
OpenRouterApiKeyAuth
required
integrations
typing.List[OpenRouterIntegrations]
required
List of integrations that are associated with the OpenRouter provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

OtelExporterGrpcConfigBase

endpoint
str
required
Endpoint URL where OpenTelemetry data will be sent
headers
typing.Optional[typing.Dict[(str, str)]]
gRPC metadata to include in OpenTelemetry export requests

OtelExporterHttpConfigBase

endpoint
str
required
Endpoint URL where OpenTelemetry data will be sent
encoding
OtelExporterHttpConfigBaseEncoding
required
πŸ”— OtelExporterHttpConfigBaseEncodingEncoding for OpenTelemetry data
headers
typing.Optional[typing.Dict[(str, str)]]
HTTP headers to include in OpenTelemetry export requests

OtelMetricsExporterGrpcConfig

type
typing.Literal[Any]
default:"grpc"
required
Configuration type

OtelMetricsExporterHttpConfig

type
typing.Literal[Any]
default:"http"
required
Configuration type

OtelTracesExporterCommonConfig

additional_resource_attributes
typing.Optional[typing.Dict[(str, str)]]
Set additional attributes to append them to existing resource attributes of every exported trace
exclude_request_data
typing.Optional[bool]
Enable to prevent forwarding the LLM or MCP request and response body in exported traces. The following span attributes are dropped: tfy.input, tfy.output, tfy.input_short_hand
when
typing.Optional[typing.List[OtelTracesExporterSpanAttributeFilter]]
πŸ”— OtelTracesExporterSpanAttributeFilterExport spans only when they match all of the following filters. Only matching on spanAttributes with string values in supported.

OtelTracesExporterGrpcConfig

type
typing.Literal[Any]
default:"grpc"
required
Configuration type

OtelTracesExporterHttpConfig

type
typing.Literal[Any]
default:"http"
required
Configuration type

OtelTracesExporterSpanAttributeFilter

field
typing.Literal[Any]
default:"spanAttributes"
required
Type of attribute field to filter on
key
str
required
Key name of the span attribute to filter on
operator
typing.Literal[Any]
default:"IN"
required
Comparison operator to use for filtering
value
typing.List[str]
required
Values

OwnDataAccessRule

scope
typing.Literal[Any]
default:"own_data"
required
Data access scope - access to own data only

OwnedBy

account
str
required
The name of the account that owns this resource

PaddleFramework

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

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
The name of the PagerDuty provider account
integrations
typing.List[PagerDutyIntegrations]
required
πŸ”— PagerDutyIntegrationList of integrations that are associated with the PagerDuty provider account
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

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
Your PaLM API key for authentication

PalmModel

type
typing.Literal[Any]
default:"integration/model/palm"
required
name
str
required
Name to identify this PaLM model in the UI
model_id
str
required
The name of the PaLM model to use
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
The name of the PaLM provider account
auth_data
PalmKeyAuth
required
integrations
typing.List[PalmIntegrations]
required
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
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

PaloAltoPrismaAirsGuardrailConfig

name
str
required
The name of the Guardrail Config.
description
typing.Optional[str]
Optional description for this Guardrail Config.
type
typing.Literal[Any]
required
auth_data
PaloAltoPrismaAirsKeyAuth
required
operation
typing.Literal[Any]
default:"validate"
required
The operation type for this guardrail. Palo Alto Prisma AIRS guardrails can only be used for validation.
enforcing_strategy
EnforcingStrategy
required
config
PaloAltoPrismaAirsGuardrailConfigConfig
required

PaloAltoPrismaAirsGuardrailConfigConfig

base_url
typing.Optional[str]
Optional override for the base URL for Palo Alto Prisma AIRS. Defaults to https://service.api.aisecurity.paloaltonetworks.com/v1/ if not provided.
profile_name
str
required
The profile name associated with this Guardrail Config.
mode
typing.Optional[PaloAltoPrismaAirsGuardrailConfigConfigMode]
πŸ”— PaloAltoPrismaAirsGuardrailConfigConfigModeExecution mode for the guardrail. Sync waits for the guardrail check to complete before proceeding. Async triggers the check without waiting. Defaults to sync.
metadata_key_mapping
typing.Optional[typing.Dict[(str, str)]]
Map Palo Alto AIRS metadata fields to TrueFoundry request metadata keys. Key is the Palo Alto AIRS metadata field name, value is the corresponding key from X-TFY-METADATA header on the TrueFoundry side. Example: {β€œapp_user”: β€œuser_email”, β€œai_model”: β€œmodel_name”}. Reserved AIRS keys: ai_model, app_user, app_name. Docs

PaloAltoPrismaAirsKeyAuth

type
typing.Literal[Any]
default:"api-key"
required
api_key
str
required
API key for the Palo Alto Prisma AIRS account

PangeaGuardrailConfig

name
str
required
The name of the Guardrail Config.
description
typing.Optional[str]
Optional description for this Guardrail Config.
type
typing.Literal[Any]
default:"integration/guardrail-config/pangea"
required
auth_data
PangeaKeyAuth
required
operation
PangeaGuardrailConfigOperation
required
πŸ”— PangeaGuardrailConfigOperationThe operation type to use for the Guardrail. Validate guardrails are used to validate requests and mutate can validate as well as mutate requests.
priority
typing.Optional[int]
default:"1"
Execution order for mutate guardrails. Lower values run first. Only applicable when operation is mutate.
enforcing_strategy
EnforcingStrategy
required
config
PangeaGuardrailConfigConfig
required

PangeaGuardrailConfigConfig

guard_type
PangeaGuardType
required
domain
str
required
Domain of the cloud provider and region where your Pangea project is configured. Example: if endpoint is: https://<service_name>.aws.us-west-2.pangea.cloud/v1/text/guard, the input should be: aws.us-west-2.pangea.cloud
recipe
typing.Optional[str]
Recipe key from Pangea console defining security rules and data types to apply
overrides
typing.Optional[typing.Dict[(str, str)]]
Overrides for the Pangea account

PangeaKeyAuth

type
typing.Literal[Any]
default:"api-key"
required
api_key
str
required
API key for the Pangea account

Param

name
str
required
Name of the param
description
typing.Optional[str]
Description of param
default
typing.Optional[str]
Default value or placeholder
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:

PatronusAnswerRelevanceEvaluator

type
typing.Literal[Any]
default:"answer-relevance"
required
The type of the evaluator to use for the Patronus Guardrail.
criteria
PatronusAnswerRelevanceCriteria
default:"patronus:answer-relevance"
required

PatronusEvaluator

Union, One Of:

PatronusGliderEvaluator

type
typing.Literal[Any]
default:"glider"
required
The type of the evaluator to use for the Patronus Guardrail.
criteria
PatronusGliderCriteria
required

PatronusGuardrailConfig

name
str
required
The name of the Guardrail Config.
description
typing.Optional[str]
Optional description for this Guardrail Config.
type
typing.Literal[Any]
default:"integration/guardrail-config/patronus"
required
auth_data
PatronusKeyAuth
required
operation
typing.Literal[Any]
default:"validate"
required
The operation type for this guardrail. Patronus guardrails can only be used for validation.
enforcing_strategy
EnforcingStrategy
required
config
PatronusGuardrailConfigConfig
required

PatronusGuardrailConfigConfig

target
PatronusGuardrailConfigConfigTarget
required
πŸ”— PatronusGuardrailConfigConfigTargetWhere to apply evaluation: request (evaluate user input) or response (evaluate model response)
evaluators
typing.List[PatronusEvaluator]
required
πŸ”— PatronusEvaluatorPatronus evaluators guard against GenAI failures by checking for evaluation criteria, refer to docs

PatronusJudgeEvaluator

type
typing.Literal[Any]
default:"judge"
required
The type of the evaluator to use for the Patronus Guardrail.
criteria
PatronusJudgeCriteria
required

PatronusKeyAuth

type
typing.Literal[Any]
default:"api-key"
required
api_key
str
required
API key for the Patronus account

PatronusPhiEvaluator

type
typing.Literal[Any]
default:"phi"
required
The type of the evaluator to use for the Patronus Guardrail.
criteria
PatronusPhiCriteria
default:"patronus:phi"
required

PatronusPiiEvaluator

type
typing.Literal[Any]
default:"pii"
required
The type of the evaluator to use for the Patronus Guardrail.
criteria
PatronusPiiCriteria
default:"patronus:pii"
required

PatronusToxicityEvaluator

type
typing.Literal[Any]
default:"toxicity"
required
The type of the evaluator to use for the Patronus Guardrail.
criteria
PatronusToxicityCriteria
default:"patronus:toxicity"
required

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
The API key for Perplexity AI authentication

PerplexityAiModel

type
typing.Literal[Any]
default:"integration/model/perplexity-ai"
required
name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The Perplexity AI model identifier (e.g., sonar-reasoning, sonar). This is the model name from Perplexity AI’s API documentation.
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
The name of the Perplexity AI provider account
auth_data
PerplexityAiKeyAuth
required
integrations
typing.List[PerplexityIntegrations]
required
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
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

PersonalAccessTokenManifest

name
str
required
Personal Access Token Name
type
typing.Literal[Any]
default:"pat"
required
expiration_date
typing.Optional[str]
Expiration Date of the Personal Access Token (should be in the ISO 8601 format)
user_fqn
str
required
The fully qualified name of the user
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

PerThousandEmbeddingTokensCostMetric

metric
str
required
value
NonNegativeFloat
required

PerThousandTokensCostMetric

metric
str
required
value
InputOutputBasedCostMetricValue
required

Pip

type
typing.Literal[Any]
default:"pip"
required
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”]

Poetry

type
typing.Literal[Any]
default:"poetry"
required
poetry_version
typing.Optional[str]
default:"latest"
Poetry version to use
install_options
typing.Optional[str]
install options to pass to poetry command

PolicyFilters

cluster_names
typing.Optional[typing.List[str]]
Cluster names where Policy applies
workspace_names
typing.Optional[typing.List[str]]
Workspace names where Policy applies
env_names
typing.Optional[typing.List[str]]
Environment names where Policy applies

PolicyManifest

type
typing.Literal[Any]
default:"policy"
required
name
str
required
Unique identifier of the policy across the organisation
description
str
required
Description of the policy that explains what the policy does, its purpose, and how it affects resources. This helps other users understand the policy’s behavior and impact.
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
TypeScript code for Policy logic. To write and test your policy code, please refer to this repository

PolicyManifestOperation

Union, One Of:

PolicyMutationOperation

type
typing.Literal[Any]
default:"mutate"
required
Mutates or Validates Resources
order
int
required
Determines the sequence in which mutation policies are executed. Policies with lower order value run first, followed by higher value. For example, a policy with order 10 runs before one with order 20. This is crucial when multiple mutation policies need to run in a specific sequence. The order must be between 1 and 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]
Host e.g. ai.example.com, app.truefoundry.com
path
typing.Optional[str]
Path e.g. /v1/api/ml/, /v2/docs/
rewrite_path_to
typing.Optional[str]
Rewrite the path prefix to a different path. If path is /v1/api and rewrite_path_to is /api. The URI in the HTTP request http://0.0.0.0:8080/v1/api/houses will be rewritten to http://0.0.0.0:8080/api/houses before the request is forwarded your service. Defaults to /. This is only applicable if path is given.
auth
typing.Optional[PortAuth]
πŸ”— PortAuthAuthentication method for inbound traffic

PortAuth

Union, One Of:

PresetRegexPattern

presets
typing.List[PresetRegexPatternEnum]
required
πŸ”— PresetRegexPatternEnumSelect one or more common regex patterns from the predefined list.

PresignedUrlObject

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

PriorityBasedLoadBalanceTarget

target
str
required
Target model or provider FQN
priority
int
required
Priority for the target, Lower the number, higher the priority (0 is the highest priority)
sla_cutoff
typing.Optional[SlaCutoff]
retry_config
typing.Optional[RetryConfig]
fallback_status_codes
typing.Optional[typing.List[str]]
Status Codes for which the request will fallback to other targets. If the status code is not present in fallback_status_codes, it fails immediately.
fallback_candidate
typing.Optional[bool]
Whether this target is a fallback candidate. If set to false, this model will not be considered as a fallback option for targets of this load-balance-rule
override_params
typing.Optional[typing.Dict[(str, typing.Any)]]
Optional parameters to override in the request
headers_override
typing.Optional[HeadersOverride]
metadata_match
typing.Optional[typing.Dict[(str, str)]]
Optional metadata key-value pairs that must match incoming request metadata headers for this target to be considered for routing.

PriorityBasedLoadBalancing

type
typing.Literal[Any]
default:"priority-based-routing"
required
load_balance_targets
typing.List[PriorityBasedLoadBalanceTarget]
required
πŸ”— PriorityBasedLoadBalanceTargetList of targets for priority-based load balancing

PriorityBasedLoadBalancingRule

id
str
required
Unique identifier for the rule
when
LoadBalancingWhen
required

PrivatePricingTier

from_
typing_extensions.Annotated[(int, Any, Any)]
required
cost_per_token
NonNegativeFloat
required

PrometheusAlertRule

type
typing.Literal[Any]
default:"prometheus-alert-rule"
required
Type
name
str
required
Enter a unique, descriptive name for your Prometheus alert rule. Choose a name that clearly indicates the condition being monitored. Please note that reserved alert names for TrueFoundry managed alerts are not allowed. For checking the list of reserved alert names, please refer to the documentation.
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, Any)]
required
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
Unique identifier for the artifact
ml_repo_id
str
required
ID of the ML Repo that this artifact belongs to
type
typing.Optional[typing.Literal[Any]]
Type of the artifact, always β€˜chat_prompt’ for Prompt entities
name
str
required
Name of the artifact (alphanumeric characters, hyphens, and underscores only, max 256 characters)
fqn
str
required
Fully qualified name of the artifact in the format β€˜{artifact_type}:{tenant_name}/{ml_repo_name}/{artifact_name}’
created_by_subject
Subject
required
πŸ”— SubjectSubject (user, team, or service account) that created this artifact
created_at
typing.Optional[dt.datetime]
Timestamp when the artifact was created
updated_at
typing.Optional[dt.datetime]
Timestamp when the artifact was last updated
latest_version
typing.Optional[PromptVersion]
πŸ”— PromptVersionThe most recent version of this prompt
run_steps
typing.Optional[typing.List[int]]
List of run step numbers where this artifact was created or updated

PromptSource

type
typing.Literal[Any]
default:"prompt"
required
Type of agent source
prompt_version_fqn
str
required
Fully qualified name of the prompt version to use as the agent source
skills
typing.Optional[typing.List[AgentSkill]]
πŸ”— AgentSkillList of skills associated with the agent

PromptVersion

id
str
required
Unique identifier for the artifact version
fqn
str
required
Fully qualified name of the artifact version in the format β€˜{artifact_type}:{tenant_name}/{ml_repo_name}/{artifact_name}:{version}’
created_by_subject
Subject
required
πŸ”— SubjectSubject (user, team, or service account) that created this artifact version
created_at
typing.Optional[dt.datetime]
Timestamp when the artifact version was created
updated_at
typing.Optional[dt.datetime]
Timestamp when the artifact version was last updated
manifest
ChatPromptManifest
required
πŸ”— ChatPromptManifestManifest containing metadata specific to the chat prompt version
ml_repo_id
str
required
ID of the ML Repo that this artifact version belongs to
tags
typing.Optional[typing.List[str]]
List of tags associated with this artifact version for filtering and organization
version_alias
typing.Optional[str]
Optional human-readable version alias (e.g. v1.0.0)
usage_code_snippet
typing.Optional[str]
Code snippet demonstrating how to use this artifact version
usage_code_snippets
typing.Optional[typing.List[UsageCodeSnippet]]
πŸ”— UsageCodeSnippetList of code snippets demonstrating how to use this prompt version in different languages
prompt_id
str
required
ID of the parent prompt that this version belongs to

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[str])]]
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[VolumeMount]]
πŸ”— VolumeMountConfigure data to be mounted to Workflow pod(s) as a volume.
service_account
typing.Optional[str]
Service Account

PythonBuild

type
typing.Literal[Any]
default:"tfy-python-buildpack"
required
python_version
typing.Optional[str]
Python version to run your application. Should be one of the tags listed on Official Python Docker Page
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”]
python_dependencies
typing.Optional[PythonBuildPythonDependencies]
πŸ”— PythonBuildPythonDependenciesPython dependencies to install
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:

PythonBuildPythonDependencies

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]
Service Account

PythonTaskConfigImage

Union, One Of:

PythonTaskConfigMountsItem

Union, One Of:

PyTorchFramework

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

QuayArtifactsRegistry

type
typing.Literal[Any]
default:"integration/docker-registry/quay"
required
name
str
required
The name of the integration that will be displayed in the TrueFoundry UI.
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
The name of the provider account.
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.
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

QuerySpansRequestFiltersItem

Union, One Of:

QuerySpansResponse

data
typing.List[TraceSpan]
required
πŸ”— TraceSpanArray of flat spans
pagination
TokenPagination
required
πŸ”— TokenPaginationPagination information

RateLimitConfig

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
rate_limit_applies_per
typing.Optional[typing.List[str]]
Create separate rate limiting rules for each unique value of the selected entity. For example, if β€œuser” is selected, a separate rate limit rule will be created for each unique user making requests. Options: user, virtualaccount, model, or a metadata key (e.g., metadata.appId).

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, Any)]
application_id
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
deployment_id
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
application_version
typing_extensions.Annotated[(typing.Optional[int], Any, Any)]
recommendation_data
typing_extensions.Annotated[(typing.Dict[(str, typing.Any)], Any, Any)]
required
recommendation_type
typing_extensions.Annotated[(str, Any, Any)]
required
applied_deployment_id
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
expiry_timestamp
typing_extensions.Annotated[(dt.datetime, Any, Any)]
required
created_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any, Any)]
updated_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any, Any)]

RefusalContentPart

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

RegexGuardrailConfig

name
str
required
The name of the Guardrail Config.
description
typing.Optional[str]
Optional description for this Guardrail Config.
type
typing.Literal[Any]
default:"integration/guardrail-config/regex"
required
operation
RegexGuardrailConfigOperation
required
πŸ”— RegexGuardrailConfigOperationValidate blocks when pattern matches. Mutate replaces matched text and continues.
priority
typing.Optional[int]
default:"1"
Execution order for mutate guardrails. Lower values run first. Only applicable when operation is mutate.
enforcing_strategy
EnforcingStrategy
required
config
RegexGuardrailConfigConfig
required

RegexGuardrailConfigConfig

preset_patterns
typing.Optional[PresetRegexPattern]
custom_patterns
typing.Optional[typing.List[CustomRegexPattern]]
πŸ”— CustomRegexPatternEnter your own regex patterns to match against content, each with its own redaction text (used in mutate mode).

RegisterUsersResponse

Union, One Of:

RemoteMcpServerManifest

type
typing.Literal[Any]
default:"mcp-server/remote"
required
name
str
required
The name of the MCP Server.
description
str
required
Provide a brief description of the purpose of this MCP Server.
url
str
required
The endpoint URL for the MCP Server.
tls_settings
typing.Optional[CustomTlsSettings]
tool_settings
typing.Optional[typing.List[McpToolSetting]]
πŸ”— McpToolSettingCustomize tool descriptions or enable/disable specific tools from the MCP Server.
auth_data
typing.Optional[McpServerAuth]
collaborators
typing.List[Collaborator]
required
πŸ”— CollaboratorUsers and Teams that have access to this MCP Server
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]
tags
typing.Optional[typing.Dict[(str, typing.Any)]]
Key-value pairs to categorize this MCP Server (e.g., by owner or environment).

RemoteSource

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

RemoteSpecSource

type
typing.Literal[Any]
default:"remote"
required
url
str
required
URL to fetch the OpenAPI specification (JSON or YAML format).

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:

ResponseFormatJsonObject

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

ResponseFormatJsonSchema

type
typing.Literal[Any]
default:"json_schema"
required
json_schema
ResponseFormatJsonSchemaJsonSchema
required

ResponseFormatJsonSchemaJsonSchema

name
str
required
description
typing.Optional[str]
schema_
typing_extensions.Annotated[(typing.Optional[typing.Dict[(str, typing.Any)]], Any, Any)]
strict
typing.Optional[bool]

ResponseFormatText

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

RetryConfig

attempts
int
required
Number of attempts to retry the request
delay
typing.Optional[int]
default:"100"
Delay between retries in milliseconds
on_status_codes
typing.Optional[typing.List[str]]
Status codes to retry on

RevokeAllPersonalAccessTokenResponse

Union, One Of:

RoleBindingManifest

type
typing.Literal[Any]
default:"role-binding"
required
name
str
required
Unique name for this role binding.
subjects
typing.List[RoleBindingSubject]
required
πŸ”— RoleBindingSubjectOne row per principal; set type and name (email, team name, virtual account name, or external identity name).
permissions
typing.List[RoleBindingPermission]
required
πŸ”— RoleBindingPermissionResource-scoped role grants (resource type, FQN, and role name).

RoleBindingPermission

resource_type
typing_extensions.Annotated[(str, Any, Any)]
required
resource_fqn
typing_extensions.Annotated[(str, Any, Any)]
required
role
str
required
Name of the role to bind (e.g. workspace-editor, model-user).

RoleBindingSubject

type
RoleBindingSubjectType
required
πŸ”— RoleBindingSubjectTypeWhether this row identifies a user (email), a team (name), a virtual account (name), or an external identity (name).
name
str
required
User email when type is user; team or virtual account name when type is team or virtualaccount; external identity name when type is external-identity.

RoleManifest

type
typing.Literal[Any]
default:"role"
required
name
str
required
Unique identifier of the role across the organization
display_name
typing_extensions.Annotated[(str, Any, Any)]
required
description
str
required
Description of the role that explains its purpose and permissions
resource_type
typing_extensions.Annotated[(str, Any, Any)]
required
permissions
typing.List[str]
required
Define the resource type and the corresponding actions this role can perform on the resource

RoleWithResource

role_id
typing_extensions.Annotated[(str, Any, Any)]
required
resource_type
typing_extensions.Annotated[(RoleWithResourceResourceType, Any, Any)]
required
resource_id
typing_extensions.Annotated[(str, Any, Any)]
required

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+(25% of 12) = 15) pods might be running at one time. Setting this to a higher value can help in speeding up the deployment process.

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.Literal[Any]
default:"rstudio"
required
image
WorkbenchImage
required

SagemakerModel

name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The SageMaker endpoint name you created for your model deployment. This is the name of the inference endpoint in AWS SageMaker, not the model name.
type
typing.Literal[Any]
default:"integration/model/sagemaker"
required
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the Sagemaker 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>.

SambaNovaKeyAuth

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

SambaNovaModel

type
typing.Literal[Any]
default:"integration/model/sambanova"
required
name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The SambaNova model identifier (e.g., DeepSeek-R1-0528, Meta-Llama-3.3-70B-Instruct). This is the standard Model ID from SambaNova’s model catalog.
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the SambaNova 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>.

SambaNovaProviderAccount

type
typing.Literal[Any]
default:"provider-account/sambanova"
required
name
str
required
The name of the SambaNova provider account
auth_data
SambaNovaKeyAuth
required
integrations
typing.List[SambaNovaIntegrations]
required
List of integrations that are associated with the SambaNova provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

SampleAgentInput

text
typing.Optional[str]
Input for the agent
variables
typing.Optional[typing.Dict[(str, str)]]
Variable inputs for Prompt Variables defined in the Prompt

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, Any)]
required
value
typing.Optional[str]
created_by_subject
typing_extensions.Annotated[(typing.Optional[Subject], Any, Any)]
created_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any, Any)]
updated_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any, Any)]
secret_versions
typing_extensions.Annotated[(typing.Optional[typing.List[Any]], Any, Any)]
active_deployments_count
typing_extensions.Annotated[(typing.Optional[int], Any, Any)]
created_by
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]

SecretDetectionGuardrailConfig

name
str
required
The name of the Guardrail Config.
description
typing.Optional[str]
Optional description for this Guardrail Config.
type
typing.Literal[Any]
default:"integration/guardrail-config/secret-detection"
required
operation
SecretDetectionGuardrailConfigOperation
required
πŸ”— SecretDetectionGuardrailConfigOperationThe 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.
priority
typing.Optional[int]
default:"1"
Execution order for mutate guardrails. Lower values run first. Only applicable when operation is mutate.
enforcing_strategy
EnforcingStrategy
required
config
typing.Optional[SecretDetectionGuardrailConfigConfig]

SecretDetectionGuardrailConfigConfig

redaction_text
typing.Optional[str]
default:"[REDACTED]"
Text to use when redacting detected secrets in logs and error messages. Defaults to β€˜[REDACTED]’.Only applicable in mutate mode.

SecretGroup

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

SecretGroupManifest

type
typing.Literal[Any]
default:"secret-group"
required
name
str
required
Name of the secret group
integration_fqn
str
required
Secret Store to be associated with the secret group
collaborators
typing.List[Collaborator]
required
πŸ”— CollaboratorUsers and Teams that have access to Secret Group
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, 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
Absolute file path where the file will be created.
secret_fqn
str
required
The TrueFoundry secret whose value will be the file content.

SecretStoreConfig

integration_fqn
str
required
The secret store to store the virtual account token in
secret_path
str
required
The path where the virtual account token will be stored in the secret store (example: secret/path/to/virtual-account-token)

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, Any)]
created_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any, Any)]
updated_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any, Any)]

SelfHostedAgent

type
typing.Literal[Any]
default:"remote-agent/self-hosted"
required
Type of the manifest
url
str
required
The URL of the server
auth_data
typing.Optional[CustomAgentServerAuth]
framework
AgentFramework
required

SelfHostedModel

type
typing.Literal[Any]
default:"integration/model/self-hosted-model"
required
name
str
required
A descriptive name to identify this self-hosted model in the UI
hosted_model_name
str
required
The name of the hosted model
url
str
required
The URL where the model is hosted
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
tls_settings
typing.Optional[CustomTlsSettings]
auth_data
typing.Optional[SelfHostedModelAuthData]
πŸ”— SelfHostedModelAuthDataSelf Hosted Model authentication data for the integration.
headers
typing.Optional[typing.Dict[(str, str)]]
Self Hosted Model 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
The name of the provider account.
integrations
typing.List[SelfHostedModelIntegrations]
required
πŸ”— SelfHostedModelList of integrations that are associated with the provider account.
collaborators
typing.Optional[typing.List[Collaborator]]
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

SemanticCacheConfig

type
typing.Literal[Any]
default:"semantic"
required
similarity_threshold
float
required
Similarity threshold for semantic matching (between 0 and 1)
namespace
typing.Optional[str]
Cache namespace (defaults to β€˜default’ if not provided)
ttl
float
default:"3600.0"
required
Time-to-live for cached entries in seconds (max 3 days)

SemanticCacheSettings

semantic_cache_embedding_model
str
required
Select the embedding model to use for semantic caching across the gateway. This model will be used to generate embeddings for cache lookups when semantic caching is enabled. The embedding model helps identify semantically similar requests to serve cached responses, improving performance for similar queries.

Service

type
typing.Literal[Any]
default:"service"
required
replicas
ServiceReplicas
required
πŸ”— 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
ServiceAutoscalingMetrics
required
πŸ”— 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[(typing.Optional[str], Any, Any)]
subject_slug
typing_extensions.Annotated[(str, Any, Any)]
required
subject_controller_name
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
subject_pat_name
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
email
typing.Optional[str]
subject_type
typing_extensions.Annotated[(SubjectType, Any, Any)]
required
tenant_name
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
roles
typing.List[str]
required
teams
typing.List[SessionTeam]
required
accounts
typing.List[SessionAccount]
required
metadata
typing.Optional[UserMetadata]
is_billing_enabled
typing_extensions.Annotated[(typing.Optional[bool], Any, Any)]
service_account_metadata
typing_extensions.Annotated[(typing.Optional[typing.Dict[(str, typing.Any)]], Any, Any)]
account
typing.Optional[Account]
root_account
typing_extensions.Annotated[(typing.Optional[Account], Any, Any)]
effective_user_id
typing_extensions.Annotated[(str, Any, Any)]
required

SessionAccount

name
str
required
id
str
required

SessionTeam

name
str
required
id
str
required

SignedUrl

path
str
required
Relative path of the file within the artifact storage
signed_url
str
required
Pre-signed URL that can be used to access the file directly

SklearnFramework

type
typing.Literal[Any]
default:"sklearn"
required
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.Any)]]
required
Schema of the input
outputs
typing.List[typing.Dict[(str, typing.Any)]]
required
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
List of channels to send messages to.

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
The name of the integration that will be displayed in the TrueFoundry UI.
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
The name of the provider account.
integrations
typing.List[SlackIntegrations]
required
πŸ”— SlackIntegrationsList of integrations that are associated with the provider account.
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

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
The name of the integration that will be displayed in the TrueFoundry UI.
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>.

SlaCutoff

time_per_output_token_ms
typing.Optional[int]
Time per output token threshold in milliseconds. If time per output token exceeds this value, the target will be marked as unhealthy

SmtpCredentials

type
typing.Literal[Any]
default:"smtp-credentials"
required
host
str
required
The SMTP host of the email server.
username
typing.Optional[str]
The username for the SMTP server.
password
typing.Optional[str]
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.

SnowflakeCortexModel

type
typing.Literal[Any]
default:"integration/model/snowflake-cortex"
required
name
str
required
Name to identify this Snowflake Cortex model in the UI
model_id
str
required
ID of the Snowflake Cortex model to use
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the Snowflake Cortex 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>.

SnowflakeCortexPatTokenAuth

type
typing.Literal[Any]
default:"pat-token"
required
pat_token
str
required
PAT token for Snowflake Cortex authentication

SnowflakeCortexProviderAccount

type
typing.Literal[Any]
default:"provider-account/snowflake-cortex"
required
name
str
required
The name of the Snowflake Cortex provider account
auth_data
SnowflakeCortexPatTokenAuth
required
account_identifier
str
required
Snowflake account identifier. You can find it in the URL of your Snowflake account. Example: https://<account_identifier>.snowflakecomputing.com. Insert the account identifier only, without the URL.
integrations
typing.List[SnowflakeCortexIntegrations]
required
List of integrations that are associated with the Snowflake Cortex provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

SpaCyFramework

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

SpanAttributeFilter

span_attribute_key
typing_extensions.Annotated[(str, Any, Any)]
required
operator
SpanAttributeFilterOperator
required
value
SpanAttributeFilterValue
required

SpanAttributeFilterValue

Union, One Of:

SpanFieldFilter

span_field_name
typing_extensions.Annotated[(SpanFieldFilterSpanFieldName, Any, Any)]
required
operator
SpanFieldFilterOperator
required
value
SpanFieldFilterValue
required

SpanFieldFilterValue

Union, One Of:

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
The base domain for the cluster with which you can access your Spark UI

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
build_spec
SparkBuild
required

SparkImageBuildBuildSource

Union, One Of:

SparkJob

type
typing.Literal[Any]
default:"spark-job"
required
name
str
required
Name of the job
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.Any)]]
Configure environment variables to be injected in the service either as plain text. Docs
spark_conf
typing.Optional[typing.Dict[(str, typing.Optional[str])]]
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]
Service Account
workspace_fqn
typing.Optional[str]
Fully qualified name of the workspace

SparkJobEntrypoint

Union, One Of:

SparkJobImage

Union, One Of:

SparkJobJavaEntrypoint

type
typing.Literal[Any]
default:"java"
required
main_application_file
str
required
The main application file to be executed by the spark job.
main_class
str
required
The main class to be executed by the spark job.
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
The main application file to be executed by the spark job. Relative path in case of git repository.
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
The main application file to be executed by the spark job. Relative path in case of git repository.

SparkJobScalaEntrypoint

type
typing.Literal[Any]
default:"scala"
required
main_application_file
str
required
The main application file to be executed by the spark job.
main_class
str
required
The main class to be executed by the spark job.
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
The main application file to be executed by the spark job. Relative path in case of git repository.

SparkJobTriggerInput

main_class
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
main_application_file
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
arguments
typing.Optional[str]
Arguments to pass to the main application file

SqlSanitizerGuardrailConfig

name
str
required
The name of the Guardrail Config.
description
typing.Optional[str]
Optional description for this Guardrail Config.
type
typing.Literal[Any]
default:"integration/guardrail-config/sql-sanitizer"
required
operation
SqlSanitizerGuardrailConfigOperation
required
πŸ”— SqlSanitizerGuardrailConfigOperationValidate (detect and block) or Mutate (detect, sanitize comments, and continue).
priority
typing.Optional[int]
default:"1"
Execution order for mutate guardrails. Lower values run first. Only applicable when operation is mutate.
enforcing_strategy
EnforcingStrategy
required
config
SqlSanitizerGuardrailConfigConfig
required

SqlSanitizerGuardrailConfigConfig

block_drop
typing.Optional[bool]
Block SQL DROP statements as dangerous operations.
block_truncate
typing.Optional[bool]
Block SQL TRUNCATE statements as dangerous operations.
block_alter
typing.Optional[bool]
Block SQL ALTER statements as dangerous operations.
block_grant
typing.Optional[bool]
Block SQL GRANT statements as dangerous operations.
block_revoke
typing.Optional[bool]
Block SQL REVOKE statements as dangerous operations.
strip_comments
typing.Optional[bool]
Remove SQL comments (β€” and block comments) from queries. In mutate mode, comments are stripped from the output.
block_delete_without_where
typing.Optional[bool]
Flag DELETE FROM statements that lack a WHERE clause as potentially dangerous.
block_update_without_where
typing.Optional[bool]
Flag UPDATE statements that lack a WHERE clause as potentially dangerous.
require_parameterization
typing.Optional[bool]
Detect naive string interpolation patterns (+, %., {}) that may indicate SQL injection vulnerabilities.

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
typing.Optional[AwsAccessKeyAuth]

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
typing.Optional[AwsAccessKeyAuth]

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.
auth
typing.Optional[SqsQueueMetricConfigAuth]
πŸ”— SqsQueueMetricConfigAuthReceive permissions on the SQS Queue

SqsQueueMetricConfigAuth

Union, One Of:

SshServer

type
typing.Literal[Any]
default:"ssh-server"
required
image
WorkbenchImage
required
ssh_public_key
str
required
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
The base domain for the cluster with which you can access your SSH containers
port
float
required
The port for the cluster with which you can access your SSH containers

StageArtifactRequestManifest

Union, One Of:

StageArtifactResponse

id
str
required
ID of the staged artifact version
storage_root
str
required
Root storage path where the artifact version files should be uploaded
artifact_id
str
required
ID of the artifact that the staged version belongs to

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

StdioMcpServerManifest

name
str
required
The name of the MCP Server.
description
str
required
Provide a brief description of the purpose of this MCP Server.
collaborators
typing.List[Collaborator]
required
πŸ”— CollaboratorUsers and Teams that have access to this MCP Server
type
typing.Literal[Any]
default:"mcp-server/stdio"
required
command
str
default:"npx"
required
Executable to run for the stdio MCP server process.
args
typing.Optional[typing.List[str]]
Arguments passed to the stdio MCP server command.
auth_data
typing.Optional[McpServerEnvAuth]
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]
tags
typing.Optional[typing.Dict[(str, typing.Any)]]
Key-value pairs to categorize this MCP Server (e.g., by owner or environment).

StickyRouting

ttl_seconds
int
required
Sticky mapping TTL in seconds
session_identifiers
typing.List[StickySessionIdentifier]
required
πŸ”— StickySessionIdentifierList of identifier selectors used to build sticky key

StickySessionIdentifier

source
StickySessionIdentifierSource
required
πŸ”— StickySessionIdentifierSourceSource from which session identifier value will be extracted
key
str
required
Key to read from selected source

StringDataMount

type
typing.Literal[Any]
default:"string"
required
mount_path
str
required
Absolute file path where the file will be created.
data
str
required
The file content.

SubAgent

name
str
required
Name of the sub agent

Subject

subject_id
typing_extensions.Annotated[(str, Any, Any)]
required
subject_type
typing_extensions.Annotated[(SubjectType, Any, Any)]
required
subject_slug
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
subject_display_name
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
subject_pat_name
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
subject_controller_name
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
subject_external_identity_slug
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]

SubjectClause

in_
typing_extensions.Annotated[(typing.Optional[typing.List[str]], Any, Any)]
not_in
typing.Optional[typing.List[str]]

SubjectConditionGroup

operator
SubjectConditionGroupOperator
required
conditions
SubjectClause
required

SubjectPermission

resource_type
typing_extensions.Annotated[(str, Any, Any)]
required
resource_id
typing_extensions.Annotated[(str, Any, Any)]
required
resource_name
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
resource_fqn
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
role_id
typing_extensions.Annotated[(str, Any, Any)]
required
role_name
typing_extensions.Annotated[(str, Any, Any)]
required
subject_id
typing_extensions.Annotated[(str, Any, Any)]
required
subject_type
typing_extensions.Annotated[(str, Any, Any)]
required

SyncTokenInSecretStoreInfo

updated_at
typing_extensions.Annotated[(str, Any, Any)]
required
error
typing.Optional[str]
Error message if sync failed

SyncVirtualAccountTokenResponse

sync_token_in_secret_store_info
typing_extensions.Annotated[(SyncTokenInSecretStoreInfo, Any, Any)]
required

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:

TargetClause

mcp_servers
typing_extensions.Annotated[(typing.Optional[InNotInOperator], Any, Any)]
mcp_tools
typing_extensions.Annotated[(typing.Optional[McpToolsOperator], Any, Any)]
model
typing.Optional[InNotInOperator]

TargetConditionGroup

operator
typing.Literal[Any]
default:"or"
required
conditions
TargetClause
required

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)]]
Build arguments to pass to docker build

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.
container_image
typing.Optional[str]
Custom container image URI. If provided, this image is used instead of the default Spark base image (public.ecr.aws/bitnami/spark). The image must be Debian-based and have Python and Spark pre-installed.
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]
Python version to run your application. Should be one of the tags listed on Official Python Docker 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”]
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
description
str
required
tenant_name
typing_extensions.Annotated[(str, Any, Any)]
required
account_id
typing_extensions.Annotated[(str, Any, Any)]
required
created_by_subject
typing_extensions.Annotated[(Subject, Any, Any)]
required
members
typing.Optional[typing.List[str]]
created_at
typing_extensions.Annotated[(dt.datetime, Any, Any)]
required
updated_at
typing_extensions.Annotated[(dt.datetime, Any, Any)]
required
manifest
TeamManifest
required
metadata
typing.Optional[TeamMetadata]
is_editable
typing_extensions.Annotated[(bool, Any, Any)]
required

TeamDataAccessRule

scope
typing.Literal[Any]
default:"team_data"
required
Data access scope - access to team data including owned virtual accounts

TeamManifest

type
typing.Literal[Any]
default:"team"
required
name
str
required
Name of the Team
managers
typing.Optional[typing.List[str]]
Emails of each of the user who can manage the members of the team. Any tenant admin is by default a team manager.
members
typing.List[str]
required
Enter email of each of the user you want to add in the team.
owned_by
typing_extensions.Annotated[(typing.Optional[TeamOwnedBy], Any, Any)]
tags
typing.Optional[typing.Dict[(str, typing.Any)]]
Key-value pairs to categorize this Team (e.g., by owner or environment).

TeamMetadata

created_by_scim
typing_extensions.Annotated[(typing.Optional[bool], Any, Any)]

TeamOwnedBy

account
str
required
The name of the account that owns the team

TensorFlowFramework

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

TerminateJobResponse

message
str
required
Terminate Job Message
job_run_status
typing_extensions.Annotated[(JobRunStatus, Any, Any)]
required

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:

TfyContentModerationGuardrailConfig

name
str
required
The name of the Guardrail Config.
description
typing.Optional[str]
Optional description for this Guardrail Config.
type
typing.Literal[Any]
required
operation
typing.Literal[Any]
default:"validate"
required
The operation type for this guardrail. TrueFoundry Content Moderation guardrails can only be used for validation.
enforcing_strategy
EnforcingStrategy
required
config
TfyContentModerationGuardrailConfigConfig
required

TfyContentModerationGuardrailConfigConfig

severity_threshold
float
default:"2.0"
required
Minimum severity level (0-6) to flag content. 0=Safe, 2=Low risk, 4=Medium risk, 6=High risk
categories
typing.List[AzureContentSafetyCategory]
required
πŸ”— AzureContentSafetyCategoryTypes of harmful content to detect: Hate (hate speech), SelfHarm (self-injury), Sexual (sexual content), Violence (violent content)

TfyPiiGuardrailConfig

name
str
required
The name of the Guardrail Config.
description
typing.Optional[str]
Optional description for this Guardrail Config.
type
typing.Literal[Any]
default:"integration/guardrail-config/tfy-pii"
required
operation
TfyPiiGuardrailConfigOperation
required
πŸ”— TfyPiiGuardrailConfigOperationThe 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.
priority
typing.Optional[int]
default:"1"
Execution order for mutate guardrails. Lower values run first.
enforcing_strategy
EnforcingStrategy
required
config
TfyPiiGuardrailConfigConfig
required

TfyPiiGuardrailConfigConfig

pii_categories
typing.List[AzurePiiCategory]
required
πŸ”— AzurePiiCategoryCategories of PII to detect.

TfyPromptInjectionGuardrailConfig

name
str
required
The name of the Guardrail Config.
description
typing.Optional[str]
Optional description for this Guardrail Config.
type
typing.Literal[Any]
required
operation
typing.Literal[Any]
default:"validate"
required
The operation type for this guardrail. TrueFoundry Prompt Shield guardrails can only be used for validation.
enforcing_strategy
EnforcingStrategy
required

TogetherAiKeyAuth

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

TogetherAiModel

type
typing.Literal[Any]
default:"integration/model/together-ai"
required
name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The Together AI model identifier (e.g., deepseek-ai/DeepSeek-R1, moonshotai/Kimi-K2-Instruct-0905). This is the model name from Together AI’s model catalog.
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
The name of the Together AI provider account
auth_data
TogetherAiKeyAuth
required
integrations
typing.List[TogetherAiIntegrations]
required
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
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

TokenPagination

limit
typing.Optional[int]
Number of items per page
next_page_token
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
previous_page_token
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]

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

TraceSpan

span_id
typing_extensions.Annotated[(str, Any, Any)]
required
trace_id
typing_extensions.Annotated[(str, Any, Any)]
required
parent_span_id
typing_extensions.Annotated[(str, Any, Any)]
required
service_name
typing_extensions.Annotated[(str, Any, Any)]
required
span_name
typing_extensions.Annotated[(str, Any, Any)]
required
span_kind
typing_extensions.Annotated[(str, Any, Any)]
required
scope_name
typing_extensions.Annotated[(str, Any, Any)]
required
scope_version
typing_extensions.Annotated[(str, Any, Any)]
required
timestamp
str
required
Timestamp in ISO 8601 format (e.g., 2025-03-12T00:00:09.872Z).
duration_ns
typing_extensions.Annotated[(float, Any, Any)]
required
status_code
typing_extensions.Annotated[(str, Any, Any)]
required
status_message
typing_extensions.Annotated[(str, Any, Any)]
required
span_attributes
typing_extensions.Annotated[(typing.Dict[(str, typing.Any)], Any, Any)]
required
events
typing.List[typing.Dict[(str, typing.Any)]]
required
Array of events that occurred during the span execution.
created_by_subject
typing_extensions.Annotated[(Subject, Any, Any)]
required
feedbacks
typing.Optional[typing.List[typing.List[typing.Any]]]
Gateway feedbacks associated with this span (if any).

TracingProjectControlPlaneManagedStorage

type
typing.Literal[Any]
default:"controlplane-managed"
required
Type of storage configuration

TracingProjectCustomerManagedStorage

type
typing.Literal[Any]
default:"customer-managed"
required
Type of storage configuration
storage_integration_fqn
str
required
Storage Integration FQN to store traces and spans. A storage integration represents a connected blob storage like AWS S3 / Azure Blob Storage / Google Cloud Storage. Please note that this cannot be changed once set.

TracingProjectManifest

type
typing.Literal[Any]
default:"tracing-project"
required
name
str
required
Name of the Tracing Project
storage
TracingProjectStorageConfig
required
description
typing.Optional[str]
Description for the Tracing Project.
collaborators
typing.List[Collaborator]
required
πŸ”— CollaboratorUsers and Teams that have access to Tracing Project
traces_retention_duration_days
typing.Optional[float]
Number of days to retain traces for (minimum 7 days). Traces older than these number of days will be deleted automatically. When not set, traces are retained indefinitely. Note: Metrics will be retained regardless of this setting.
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

TracingProjectStorageConfig

Union, One Of:

TransformersFramework

type
typing.Literal[Any]
default:"transformers"
required
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, Any)]
required
data
JobRun
required
πŸ”— JobRunDetails of the triggered job run

TrojAiClientIdAuth

type
typing.Literal[Any]
default:"client-id"
required
client_id
str
required
The client ID that identifies your TrojAI firewall policy (sent as x-eag-clientid header)

TrojAiGuardrailConfig

name
str
required
The name of the Guardrail Config.
description
typing.Optional[str]
Optional description for this Guardrail Config.
type
typing.Literal[Any]
default:"integration/guardrail-config/trojai"
required
auth_data
TrojAiClientIdAuth
required
operation
TrojAiGuardrailConfigOperation
required
πŸ”— TrojAiGuardrailConfigOperationThe 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.
priority
typing.Optional[int]
default:"1"
Execution order for mutate guardrails. Lower values run first. Only applicable when operation is mutate.
enforcing_strategy
EnforcingStrategy
required
config
TrojAiGuardrailConfigConfig
required

TrojAiGuardrailConfigConfig

base_url
str
required
The base URL of the TrojAI firewall (e.g. https://your-trojai-firewall-host)

TrueFoundryAgentManifest

type
typing.Literal[Any]
default:"truefoundry-agent"
required
Type of the manifest
name
str
required
The name of the Agent
description
str
required
The description of the Agent
tags
typing.Optional[typing.Dict[(str, typing.Any)]]
Tags for the Agent
model
str
required
Model for the Agent
model_params
typing.Optional[TrueFoundryAgentManifestModelParams]
πŸ”— TrueFoundryAgentManifestModelParamsModel parameters (default and extra). Keys are param names, values are float, int, bool, or string.
skills
typing.Optional[typing.List[TrueFoundryAgentSkill]]
πŸ”— TrueFoundryAgentSkillList of agent skills to attach to this agent
mcp_servers
typing.Optional[typing.List[TrueFoundryAgentMcpServer]]
πŸ”— TrueFoundryAgentMcpServerList of MCP servers with name, enable_all_tools, and optional tools filter
instruction
typing.Optional[str]
System instruction or prompt for the agent
messages
typing.Optional[typing.List[TrueFoundryAgentUserMessage]]
πŸ”— TrueFoundryAgentUserMessagePre-defined initial messages for the agent. Supports template variable replacement.
variables
typing.Optional[typing.Dict[(str, TrueFoundryAgentVariable)]]
πŸ”— TrueFoundryAgentVariableVariables keyed by name. Each has optional default_value and optional description.
response_format
typing.Optional[TrueFoundryAgentManifestResponseFormat]
πŸ”— TrueFoundryAgentManifestResponseFormatJSON schema or structure for the agent response format
sandbox
typing.Optional[TrueFoundryAgentManifestSandbox]
iteration_limit
typing.Optional[int]
Maximum number of iterations for the agent
collaborators
typing.List[Collaborator]
required
πŸ”— CollaboratorList of users who have access to this Agent
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

TrueFoundryAgentManifestModelParams

max_tokens
typing.Optional[int]
Maximum number of tokens to generate.
reasoning_effort
typing.Optional[TrueFoundryAgentManifestModelParamsReasoningEffort]
πŸ”— TrueFoundryAgentManifestModelParamsReasoningEffortReasoning depth when the model and provider support this parameter.
temperature
typing.Optional[float]
Sampling temperature (0–2). Higher values increase randomness.
top_p
typing.Optional[float]
Nucleus sampling threshold (0–1). Alternative to temperature.

TrueFoundryAgentManifestResponseFormat

Union, One Of:

TrueFoundryAgentManifestSandbox

enabled
bool
required

TrueFoundryAgentMcpServer

name
str
required
MCP server name
deferred
typing.Optional[bool]
When true, tools from this server are loaded lazily (deferred loading).
tools
typing.Optional[typing.List[TrueFoundryAgentMcpTool]]
πŸ”— TrueFoundryAgentMcpToolList of tools to enable from this server

TrueFoundryAgentMcpTool

name
str
required

TrueFoundryAgentSkill

fqn
str
required
Fully qualified name of the agent skill
preload_skill_md
bool
required
If true, the SKILL.md content is injected into the agent context.

TrueFoundryAgentUserMessage

role
typing.Literal[Any]
default:"user"
required
Role of the message sender.
content
str
required
Content of the user message. Supports template variables like {{variable_name}}.

TrueFoundryAgentVariable

default_value
typing.Optional[str]
Default value for the variable
description
typing.Optional[str]
Description of the variable

TrueFoundryApplyRequestManifest

Union, One Of:

TrueFoundryApplyResponse

existing_manifest
typing_extensions.Annotated[(typing.Optional[TrueFoundryApplyResponseExistingManifest], Any, Any)]
action
typing.Optional[TrueFoundryApplyResponseAction]
πŸ”— TrueFoundryApplyResponseActionThe action performed: CREATE or UPDATE
data
typing.Optional[typing.Dict[(str, typing.Any)]]
The created or updated resource

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
The name of the integration that will be displayed in the TrueFoundry UI.
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
uri
typing.Optional[str]

TrueFoundryProviderAccount

type
typing.Literal[Any]
default:"provider-account/truefoundry"
required
name
str
required
The name of the provider account.
integrations
typing.Optional[typing.List[TrueFoundryIntegrations]]
List of integrations that are associated with the provider account.
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

TtlProviderAccount

type
typing.Literal[Any]
default:"provider-account/ttl"
required
name
str
required
The name of the provider account.
integrations
typing.List[TtlIntegrations]
required
List of integrations that are associated with the provider account.
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

TtlRegistry

type
typing.Literal[Any]
default:"integration/docker-registry/ttl"
required
name
str
required
The name of the integration that will be displayed in the TrueFoundry UI.
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, Any)]
desired_manifest
typing_extensions.Annotated[(typing.Optional[Helm], Any, Any)]
upgrade_possible
typing_extensions.Annotated[(typing.Optional[bool], Any, Any)]
conflict_fields
typing_extensions.Annotated[(typing.Optional[typing.List[str]], Any, Any)]
has_conflict
typing_extensions.Annotated[(typing.Optional[bool], Any, Any)]

UploadSpecSource

type
typing.Literal[Any]
default:"upload"
required
url
str
required
Cloud storage path where the OpenAPI specification is stored (S3, GCS, or Azure Blob).

UsageCodeSnippet

display_name
str
required
Display name for the code snippet (e.g., β€˜Python’, β€˜JavaScript’)
language
str
required
Programming language of the code snippet (e.g., β€˜python’, β€˜javascript’)
libraries
typing.Optional[typing.List[str]]
List of libraries/frameworks used in the code snippet
code
str
required
Code snippet demonstrating how to use the prompt version

User

id
str
required
email
str
required
tenant_name
typing_extensions.Annotated[(str, Any, Any)]
required
metadata
UserMetadata
required
roles
typing.Optional[typing.List[str]]
roles_with_resource
typing_extensions.Annotated[(typing.Optional[typing.List[RoleWithResource]], Any, Any)]
accounts
typing.Optional[typing.List[AccountInfo]]
active
bool
required
is_editable
typing_extensions.Annotated[(bool, Any, Any)]
required
created_at
typing_extensions.Annotated[(dt.datetime, Any, Any)]
required
updated_at
typing_extensions.Annotated[(dt.datetime, Any, 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:

UserMessageContentOneItem

Union, One Of:

UserMetadata

sub
typing.Optional[str]
image_url
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
picture_download_path
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
display_name
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
user_object
typing_extensions.Annotated[(typing.Optional[typing.Dict[(str, typing.Any)]], Any, Any)]
invite_accepted
typing_extensions.Annotated[(typing.Optional[bool], Any, Any)]
registered_in_idp
typing_extensions.Annotated[(typing.Optional[bool], Any, Any)]
preference
typing.Optional[typing.Dict[(str, typing.Any)]]
groups
typing.Optional[typing.List[str]]
tenant_role_managed_by
typing_extensions.Annotated[(typing.Optional[UserMetadataTenantRoleManagedBy], Any, Any)]
sso_name
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
is_primary_sso
typing_extensions.Annotated[(typing.Optional[bool], Any, Any)]
scim_user_object
typing_extensions.Annotated[(typing.Optional[typing.Dict[(str, typing.Any)]], Any, Any)]
created_by_scim
typing_extensions.Annotated[(typing.Optional[bool], Any, Any)]

UserResource

resource_type
typing_extensions.Annotated[(str, Any, Any)]
required
resource_id
typing_extensions.Annotated[(str, Any, Any)]
required
role_id
typing_extensions.Annotated[(str, Any, Any)]
required
resource_name
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]

UserTeamInfo

team_name
typing_extensions.Annotated[(str, Any, Any)]
required
roles
typing.List[str]
required
Roles of the user in the team

Uv

type
typing.Literal[Any]
default:"uv"
required
uv_version
typing.Optional[str]
default:"latest"
UV version to use
sync_options
typing.Optional[str]
Sync options to pass to uv command

ValidationError

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

ValidationErrorLocItem

Union, One Of:

VertexKeyFileAuth

type
typing.Literal[Any]
default:"key-file"
required
key_file_content
VertexKeyFileAuthKeyFileContent
required
πŸ”— VertexKeyFileAuthKeyFileContentJSON from a downloadable Google Cloud service account key (type service_account). Not for Workload Identity Federation; use authentication type Workload Identity Federation file (workload-identity-federation-file) for gcloud iam workload-identity-pools create-cred-config output.

VertexKeyFileAuthKeyFileContent

Union, One Of:

VertexModel

type
typing.Literal[Any]
default:"integration/model/vertex"
required
name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The Google Vertex AI model identifier (e.g., gemini-2.5-pro, anthropic/claude-sonnet-4-5@20250929). This is the model version name from Vertex AI’s model catalog.
region
typing.Optional[VertexRegion]
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>.

VertexWifFileAuth

type
typing.Literal[Any]
default:"workload-identity-federation-file"
required
key_file_content
VertexWifFileAuthKeyFileContent
required
πŸ”— VertexWifFileAuthKeyFileContentJSON credential configuration for Workload Identity Federation (ADC type external_account), for example from gcloud iam workload-identity-pools create-cred-config. This is not a service account private key. Same field name as key-file auth (key_file_content); use auth_data.type workload-identity-federation-file vs key-file to distinguish.

VertexWifFileAuthKeyFileContent

Union, One Of:

VirtualAccount

id
str
required
type
str
required
tenant_name
typing_extensions.Annotated[(str, Any, Any)]
required
manifest
typing.Optional[VirtualAccountManifest]
jwt_id
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
created_by_subject
typing_extensions.Annotated[(Subject, Any, Any)]
required
created_at
typing_extensions.Annotated[(dt.datetime, Any, Any)]
required
updated_at
typing_extensions.Annotated[(dt.datetime, Any, Any)]
required
is_expired
typing_extensions.Annotated[(typing.Optional[bool], Any, Any)]
jwts
typing.Optional[typing.List[Jwt]]
account_id
typing_extensions.Annotated[(str, Any, Any)]
required
metadata
typing.Optional[typing.Dict[(str, typing.Any)]]
role_ids
typing_extensions.Annotated[(typing.Optional[typing.List[str]], Any, Any)]
roles_with_resource
typing_extensions.Annotated[(typing.Optional[typing.List[RoleWithResource]], Any, Any)]
created_by
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
next_scheduled_rotation
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]

VirtualAccountManifest

name
str
required
Virtual Account Name
type
typing.Literal[Any]
default:"virtual-account"
required
permissions
typing.List[Permissions]
required
expiration_date
typing.Optional[str]
Expiration Date of the Virtual Account (should be in the format yyyy-mm-dd)
auto_rotate
typing.Optional[AutoRotate]
notification_target
typing.Optional[NotificationTarget]
secret_store_config
typing.Optional[SecretStoreConfig]
owned_by
typing_extensions.Annotated[(typing.Optional[VirtualAccountOwnedBy], Any, Any)]
tags
typing.Optional[typing.Dict[(str, typing.Any)]]
Key-value pairs to categorize this Virtual Account (e.g., by owner or environment).

VirtualAccountOwnedBy

account
typing.Optional[str]
The name of the account that owns this resource
team
str
required
The name of the team that owns this resource

VirtualMcpServerIntegration

type
typing.Literal[Any]
default:"integration/mcp-server/virtual"
required
name
str
required
The name of the Virtual MCP Server.
description
str
required
Provide a brief description of the purpose of this Virtual MCP Server.
servers
typing.List[VirtualMcpServerSource]
required
πŸ”— VirtualMcpServerSourceList of source MCP servers to include in this virtual server.
authorized_subjects
typing.Optional[typing.List[str]]
List of teams/users who can use this MCP server.

VirtualMcpServerManifest

type
typing.Literal[Any]
default:"mcp-server/virtual"
required
name
str
required
The name of the Virtual MCP Server.
description
str
required
Provide a brief description of the purpose of this Virtual MCP Server.
servers
typing.List[McpServerSource]
required
πŸ”— McpServerSourceList of source MCP servers to include in this virtual server.
collaborators
typing.List[Collaborator]
required
πŸ”— CollaboratorUsers and Teams that have access to this Virtual MCP Server
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]
tags
typing.Optional[typing.Dict[(str, typing.Any)]]
Key-value pairs to categorize this Virtual MCP Server (e.g., by owner or environment).

VirtualMcpServerSource

name
str
required
Name of the source MCP server within this group (use {provider_account_name}/{integration_name} format).
enabled_tools
typing.Optional[typing.List[str]]
List of tools to enable from this source server.
auth_data
typing.Optional[McpServerHeaderOverrideAuth]

VirtualModel

name
str
required
The name of the Virtual Model
type
typing.Literal[Any]
default:"integration/model/virtual"
required
model_types
typing.List[VirtualModelModelType]
required
πŸ”— VirtualModelModelTypeSpecify the type of the Virtual Model
slug
typing.Optional[str]
It should be a unique identifier for the virtual model. It is used to uniquely identify the virtual model. It can be used in place of virtualGroupName/virtualModelName.
routing_config
HeaderRoutingConfig
required

VirtualModelProviderAccount

name
str
required
The name of the Virtual Model Provider Group
type
typing.Literal[Any]
default:"provider-account/virtual-model"
required
integrations
typing.List[VirtualModel]
required
πŸ”— VirtualModelList of virtual models in this group
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this Virtual Model Provider Group
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

Volume

type
typing.Literal[Any]
default:"volume"
required
name
str
required
Name of the Volume. This will be set as the volume name.
config
VolumeConfig
required
πŸ”— VolumeConfigVolume Config - Volume Configuration, can be either Dynamically provisioned or statically provisioned.
volume_browser
typing.Optional[VolumeBrowser]
workspace_fqn
typing.Optional[str]
Fully qualified name of the workspace

VolumeBrowser

username
typing.Optional[str]
Username for logging in the volume browser.
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
Absolute file path where the volume will be mounted.
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
The name of the integration that will be displayed in the TrueFoundry UI.
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
The name of the provider account.
integrations
typing.List[WebhookIntegrations]
required
πŸ”— WebhookIntegrationList of integrations that are associated with the provider account.
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

WeightBasedLoadBalancing

type
typing.Literal[Any]
default:"weight-based-routing"
required
load_balance_targets
typing.List[LoadBalanceTarget]
required
πŸ”— LoadBalanceTargetList of targets for load balancing with weights
sticky_routing
typing.Optional[StickyRouting]

WeightBasedLoadBalancingRule

id
str
required
Unique identifier for the rule
when
LoadBalancingWhen
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
Name of the workflow
source
WorkflowSource
required
πŸ”— WorkflowSourceSource Code for the workflow, either local or remote
workflow_file_path
str
required
Path to the workflow file relative to the project root path
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
tenant_name
typing_extensions.Annotated[(str, Any, Any)]
required
cluster_id
typing_extensions.Annotated[(str, Any, Any)]
required
created_by_subject
typing_extensions.Annotated[(Subject, Any, Any)]
required
created_at
typing_extensions.Annotated[(dt.datetime, Any, Any)]
required
updated_at
typing_extensions.Annotated[(dt.datetime, Any, Any)]
required
environment_id
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]
manifest
WorkspaceManifest
required
account_id
typing_extensions.Annotated[(str, Any, Any)]
required
is_system_ws
typing_extensions.Annotated[(typing.Optional[bool], Any, Any)]
created_by
typing_extensions.Annotated[(typing.Optional[str], Any, Any)]

WorkspaceManifest

type
typing.Literal[Any]
default:"workspace"
required
cluster_fqn
str
required
Cluster FQN
name
str
required
Name - 3 to 32 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]]
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

WorkspacesDeleteResponse

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

XaiKeyAuth

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

XaiModel

type
typing.Literal[Any]
default:"integration/model/xai"
required
name
str
required
A descriptive name to identify this model integration in the UI
model_id
str
required
The xAI model identifier (e.g., grok-4-1-fast-reasoning, grok-4-1-fast-non-reasoning, grok-4). This is the model name from xAI’s model catalog.
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the xAI 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>.

XaiProviderAccount

type
typing.Literal[Any]
default:"provider-account/xai"
required
name
str
required
The name of the xAI provider account
auth_data
XaiKeyAuth
required
integrations
typing.Optional[typing.List[XaiIntegrations]]
List of integrations that are associated with the xAI provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account
owned_by
typing_extensions.Annotated[(typing.Optional[OwnedBy], Any, Any)]

XgBoostFramework

type
typing.Literal[Any]
default:"xgboost"
required
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.Any)]]
required
Schema of the input
outputs
typing.List[typing.Dict[(str, typing.Any)]]
required
Schema of the output