Get LLM provider
- OpenAPI 3.1.0 document: https://api.rollstack.com/public/v1/openapi.json
- The whole reference in Markdown: https://docs.rollstack.com/llms-full.txt
- An index of the reference: https://docs.rollstack.com/llms.txt
GET https://api.rollstack.com/public/v1/organization/llm-provider
The organization's custom LLM provider, without its credentials. Only owners, and members an owner allowed to manage the AI provider, may call it.
Requires the organization:read scope.
Operation ID: getLLMProvider.
Response 200
Success
application/json
id(string, required): Unique identifier for the organization's LLM provider. It stays the same when you replace the provider withsetLLMProvider; setting one up again afterdeleteLLMProvidergives a new one.type(string, required): The provider the organization's slides agent runs on, instead of Rollstack's own AI providers:anthropic(the Anthropic API),openai(the OpenAI API),azure_foundry(an Azure AI Foundry resource),amazon_bedrock(Amazon Bedrock in an AWS account) orgoogle_vertex_ai(Vertex AI in a Google Cloud project). Insights don't use it: they run on the organization'sllmProvider, fromgetOrganization. One ofanthropic,openai,azure_foundry,amazon_bedrock,google_vertex_ai.auth(string, required): How Rollstack signs in to the provider. WithapiKey, it uses a secret saved with the provider: an API key or, on Google Vertex AI, a service account key. Withoidc, the setup is keyless: your provider trusts short-lived tokens from Rollstack's OpenID Connect issuer for your organization, so no secret is saved. One ofapiKey,oidc.hasCredentials(true, required): Whether the provider has saved credentials: alwaystrue. Its secrets,apiKeyorprivateKey, are never returned, not even insettings: to change them, send the whole setup again withsetLLMProvider.settings(object, required): The provider's saved setup without its secrets: thecredentialsit was last saved with, as in thesetLLMProviderbody, minusapiKeyandprivateKey. It containsauthand, depending ontype:dataResidency(OpenAI);resourceNameandmodels(Azure AI Foundry);region,dataLocationandmodels(Amazon Bedrock); orprojectId,regionandmodels, plusclientEmailwith a service account key (Google Vertex AI). A keyless setup also contains its ids, such astenantIdandclientId, orroleArn.updatedAt(string (date-time), required): When the provider was last saved, withsetLLMProvideror in the app. Recording or clearing afailuredoesn't change it.updatedBy(object or null, required): The member who last saved the provider, withsetLLMProvideror in the app. Whenfailureis set, Rollstack notifies them, or the organization's owners if they're no longer an active member.nullif that user's account no longer exists.name(string or null, required): The name of the member who last saved the provider, as shown in Rollstack.email(string, required): The email address of the member who last saved the provider.
failure(string or null, required): Why the slides agent's calls to the provider are failing, when only a change on your provider's side can fix it.nullwhile calls work.key_invalid: the provider doesn't accept the API key or the keyless sign-in.forbidden: the key or sign-in isn't allowed to usefailedModel.model_not_found:failedModelisn't available to the account; on Azure AI Foundry, it isn't deployed under its own name, and on Amazon Bedrock or Google Vertex AI, it isn't enabled.out_of_credit: the provider account is out of credit. When it's set, Rollstack notifies the member inupdatedBy, or the owners if they're no longer an active member. It's cleared once a call tofailedModelworks again or the provider is saved again. One ofkey_invalid,forbidden,model_not_found,out_of_credit.failedAt(string (date-time) or null, required): When a slides agent call to the provider first failed with the currentfailure.nullwhile calls work.failedModel(string or null, required): The model whose call failed, such asclaude-haiku-5-5. Until the provider is saved again, only a working call to this model clearsfailure, so a failingfastmodel stays flagged even while thesmartone works.nullwhile calls work.