---
title: "Create LLM provider"
method: POST
path: "/api/{org_id}/providers"
tags: ["Providers"]
---

# Create LLM provider

`POST /api/{org_id}/providers`

## Request

- Base URL: `https://api.openobserve.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openobserve.ai/api/{org_id}/providers`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/providers/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new LLM provider configuration. The auth_config field is write-once and cannot be retrieved after creation.

## Path parameters

- `org_id` string, required

## Request body

- object: HTTP request body for creating/updating a Provider.
  - `authConfig` unknown, required
  - `availableModels` string[]
  - `defaultModel` string
  - `endpoint` string, nullable
  - `isDefault` boolean
  - `name` string, required
  - `providerType` string, required
  - `rateLimits` object, nullable

## Response `200`

Success

- object: HTTP response body for a Provider (auth_config masked).
  - `authConfigMasked` boolean, required: API key / auth config is masked in responses.
  - `availableModels` string[], required
  - `createdAt` integer, required
  - `defaultModel` string, required
  - `endpoint` string, nullable: Null for a provider on the built-in default, so the form field stays empty.
  - `id` string, required
  - `isDefault` boolean, required
  - `name` string, required
  - `orgId` string, required
  - `providerType` string, required
  - `rateLimits` object, nullable
  - `resolvedEndpoint` string, required: The URL actually called, with the default filled in when `endpoint` is null.
  - `updatedAt` integer, required

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error

---

[API](https://skmtc.dev/openobserve/apis/openobserve-api-http.md) - [All operations](https://skmtc.dev/openobserve/apis/openobserve-api-http/llms.txt) - [OpenAPI document](https://skmtc.dev/openobserve/apis/openobserve-api-http/revisions/0529b8a10252?raw)
