Skip to content
RunningLake
Company Console ↗ Request early access
Contents: Reference

BUILDING Parts of this page describe what is not built yet, and each says so.

ProviderConnection

A ProviderConnection as RunningLake's configuration repository declares it, at providerconnections/<name>.yaml. Generated from the Go types the control plane decodes this file into, so it checks the shape the gate reads — field names and types, and which fields may exist. The gate also applies rules no schema can express — required fields inside spec among them — so a file this schema accepts can still be refused by `rl diff`. Take #/properties/spec for the spec alone.

File: providerconnections/<name>.yaml

Fields

FieldTypeRequiredMeaning
apiVersion string Yes

The config schema's version, which is independent of the HTTP API's (rule unsupported-api-version).

Values: runninglake.io/v1alpha1
kind string Yes

The kind this file declares. A kind that disagrees with the file's path is refused (rule kind-mismatch).

Values: ProviderConnection
metadata object Yes
No description
metadata.name string Yes

The resource's name, which is also its path segment. It must be the name this file's path gives it (rule name-mismatch).
metadata.labels map of string No
No description
metadata.annotations map of string No
No description
spec object No

ProviderConnectionSpec is one AI provider a project may call: which kind of provider it is, where it is, which stored credential it signs in with, and the models it offers with your own price for each. It is the part of a provider that is not secret. The key is entered once in AI settings, kept under a name, and this file names it; a field that reads like a key or a token is refused. A connection is recorded and checked here, and nothing calls the provider through it yet, so it routes no model call today.
spec.provider string No

Provider is the kind of provider: anthropic, openai, openai_compatible, google_gemini, azure_openai, bedrock or vertex. A kind this build cannot call yet is accepted here and refused where it would be used.
spec.credential string No

Credential is the name of the organisation's stored credential this connection signs in with (a lower-case name of letters, digits, - and _). A connection to a kind that signs in with a cloud identity (bedrock, vertex) names none.
spec.origin string No

Origin is where the provider is reached: https, a lower-case host and an optional port, with no path. Left out, the kind's own address is used. A kind with an address of its own (anthropic, openai) ignores nothing: naming one for them is refused.
spec.region string No

Region is the provider's region as the provider spells it, or global for a provider reached through a direct API. Left out reads as global.
spec.apiVersion string No

APIVersion is the provider's own API version word (Azure's, for instance).
spec.models array of object No

Models are the models this connection offers, 1 to 50, each with the customer's price.
spec.models[].id string No

ID is the model's id as the provider spells it.
spec.models[].priceMicroCents object No

PriceMicroCents is what a million units of each class cost, in micro-cents (a millionth of a cent), as whole numbers. One dollar for a million tokens is 100000000. A class left out is unset, not zero.
spec.models[].priceMicroCents.input integer No
No description
spec.models[].priceMicroCents.output integer No
No description
spec.models[].priceMicroCents.cacheRead integer No
No description
spec.models[].priceMicroCents.cacheWrite integer No
No description

A nested field is written with its parents, spec.a.b; an item of a list is [] and a value of a map is *. Required means the parent object must carry the field; the rules a schema cannot express, such as a field that is required only inside spec, are checked by rl diff.

The schema

This page is read from the kind’s published schema, at https://runninglake.com/schema/v1alpha1/providerconnection.json. An editor that follows it checks a file of this kind as you type. To see the fields of a kind’s spec from the command line, run rl schema with the kind’s name: it works offline and prints what the gate accepts. The command reference has the rest.

All kinds