> For the complete documentation index, see [llms.txt](https://docs.zaia.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zaia.app/documentation/api-reference-alpha/reference/llm-providers.md).

# LLM Providers

## GET /api/v1/llm-providers/options

> Retrieves multiple LLM provider options.

```json
{"openapi":"3.1.0","info":{"title":"Public API","version":"1.0.0"},"servers":[{"description":"API Server","url":"https://api.endless.zaia.app"}],"paths":{"/api/v1/llm-providers/options":{"get":{"description":"Retrieves multiple LLM provider options.","tags":["LLM Providers"],"parameters":[{"schema":{"type":"string","format":"uuid","description":"A UUID v4 string that identifies an entity."},"required":false,"description":"A UUID v4 string that identifies an entity.","name":"llmProviderId","in":"query"},{"schema":{"type":"string","description":"The API key to use for authentication. Can be created in the api keys section on the workspace settings page."},"required":true,"description":"The API key to use for authentication. Can be created in the api keys section on the workspace settings page.","name":"authorization","in":"header"}],"responses":{"200":{"description":"Retrieves all available LLM models.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"aiLab":{"type":"string"},"artificialAnalysisReference":{"type":"string"},"cost":{"type":"integer","minimum":1,"exclusiveMinimum":true},"indicators":{"type":"object","properties":{"bestCostBenefit":{"type":"boolean"},"bestOverall":{"type":"boolean"},"defaultChoice":{"type":"boolean"},"deprecated":{"type":"boolean"},"fast":{"type":"boolean"},"greatForTooling":{"type":"boolean"},"score":{"type":"integer","minimum":0,"maximum":100},"smart":{"type":"boolean"}},"required":["bestCostBenefit","bestOverall","defaultChoice","deprecated","fast","greatForTooling","score","smart"]},"label":{"type":"string"},"name":{"type":"string","enum":["claude-haiku-4-5","claude-opus-4-8","claude-opus-4-6","claude-opus-4-5","claude-sonnet-4-6","claude-sonnet-4-5","gpt-5.2","gpt-5.5","gpt-5.4","gpt-5.4-mini","gpt-5.4-nano","gpt-5.6-luna","gpt-5.6-sol","gpt-5.6-terra","gemini-2.5-flash","gemini-2.5-pro","gemini-3.5-flash","gemini-3-flash","gemini-3-pro","gemini-3.1-pro","kimi-k2.5","kimi-k2.6","grok-4.3","grok-4.5"]},"provider":{"type":"string","enum":["openai","anthropic","google-ai","openrouter","xai"]}},"required":["aiLab","artificialAnalysisReference","cost","indicators","label","name","provider"]}}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"The error code."},"cta":{"type":"object","properties":{"type":{"type":"string","enum":["support-contact"]},"url":{"type":"string","format":"uri"}},"required":["type","url"],"description":"The error call-to-action."},"feedback":{"type":"object","properties":{"enUs":{"type":"string"},"esEs":{"type":"string"},"ptBr":{"type":"string"}},"description":"The error feedback."},"message":{"type":"string","description":"The error message."},"name":{"type":"string","description":"The error name."}},"required":["feedback","message","name"],"description":"The description of a known exception."}}}}}}}}}
```

## GET /api/v1/llm-providers

> Retrieves multiple LLM providers.

```json
{"openapi":"3.1.0","info":{"title":"Public API","version":"1.0.0"},"servers":[{"description":"API Server","url":"https://api.endless.zaia.app"}],"paths":{"/api/v1/llm-providers":{"get":{"description":"Retrieves multiple LLM providers.","tags":["LLM Providers"],"parameters":[{"schema":{"type":"number","minimum":1,"default":1,"description":"The page number."},"required":false,"description":"The page number.","name":"pageNumber","in":"query"},{"schema":{"type":"number","minimum":1,"maximum":100,"default":10,"description":"The page size."},"required":false,"description":"The page size.","name":"pageSize","in":"query"},{"schema":{"anyOf":[{"type":"array","items":{"type":"string","enum":["openai","anthropic","google-ai","openrouter","xai"]}},{"type":"string","enum":["openai","anthropic","google-ai","openrouter","xai"]}],"default":[]},"required":false,"name":"types","in":"query"},{"schema":{"type":"string","description":"The API key to use for authentication. Can be created in the api keys section on the workspace settings page."},"required":true,"description":"The API key to use for authentication. Can be created in the api keys section on the workspace settings page.","name":"authorization","in":"header"}],"responses":{"200":{"description":"Retrieves all LLM providers for the workspace.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"createdAt":{"type":"string","format":"date-time"},"id":{"type":"string","format":"uuid","description":"A UUID v4 string that identifies an entity."},"isRemoved":{"type":"boolean"},"updatedAt":{"type":"string","format":"date-time"},"apiKey":{"type":"string","minLength":1,"maxLength":500,"description":"The API key used to authenticate with the LLM provider."},"description":{"type":"string","nullable":true,"minLength":3,"maxLength":250,"description":"The internal description of the LLM provider configuration."},"name":{"type":"string","minLength":3,"maxLength":50,"description":"The display name of the LLM provider configuration."},"referenceId":{"type":"string","nullable":true,"format":"uuid","description":"The optional reference ID associated with the LLM provider configuration."},"type":{"type":"string","enum":["openai","anthropic","google-ai","openrouter","xai"],"description":"The upstream LLM provider type configured for this record."},"workspaceId":{"type":"string","format":"uuid","description":"The workspace ID that owns the LLM provider configuration."}},"required":["createdAt","id","isRemoved","updatedAt","apiKey","description","name","referenceId","type","workspaceId"]}}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"The error code."},"cta":{"type":"object","properties":{"type":{"type":"string","enum":["support-contact"]},"url":{"type":"string","format":"uri"}},"required":["type","url"],"description":"The error call-to-action."},"feedback":{"type":"object","properties":{"enUs":{"type":"string"},"esEs":{"type":"string"},"ptBr":{"type":"string"}},"description":"The error feedback."},"message":{"type":"string","description":"The error message."},"name":{"type":"string","description":"The error name."}},"required":["feedback","message","name"],"description":"The description of a known exception."}}}}}}}}}
```

## POST /api/v1/llm-providers

> Creates a new LLM provider.

```json
{"openapi":"3.1.0","info":{"title":"Public API","version":"1.0.0"},"servers":[{"description":"API Server","url":"https://api.endless.zaia.app"}],"paths":{"/api/v1/llm-providers":{"post":{"description":"Creates a new LLM provider.","tags":["LLM Providers"],"parameters":[{"schema":{"type":"string","description":"The API key to use for authentication. Can be created in the api keys section on the workspace settings page."},"required":true,"description":"The API key to use for authentication. Can be created in the api keys section on the workspace settings page.","name":"authorization","in":"header"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"apiKey":{"type":"string","minLength":1,"maxLength":500,"description":"The API key used to authenticate with the LLM provider."},"description":{"type":"string","nullable":true,"minLength":3,"maxLength":250,"description":"The internal description of the LLM provider configuration."},"name":{"type":"string","minLength":3,"maxLength":50,"description":"The display name of the LLM provider configuration."},"type":{"type":"string","enum":["openai","anthropic","google-ai","openrouter","xai"],"description":"The upstream LLM provider type configured for this record."}},"required":["apiKey","description","name","type"]}}}},"responses":{"200":{"description":"The LLM provider was created.","content":{"application/json":{"schema":{"type":"object","properties":{"createdAt":{"type":"string","format":"date-time"},"id":{"type":"string","format":"uuid","description":"A UUID v4 string that identifies an entity."},"isRemoved":{"type":"boolean"},"updatedAt":{"type":"string","format":"date-time"},"apiKey":{"type":"string","minLength":1,"maxLength":500,"description":"The API key used to authenticate with the LLM provider."},"description":{"type":"string","nullable":true,"minLength":3,"maxLength":250,"description":"The internal description of the LLM provider configuration."},"name":{"type":"string","minLength":3,"maxLength":50,"description":"The display name of the LLM provider configuration."},"referenceId":{"type":"string","nullable":true,"format":"uuid","description":"The optional reference ID associated with the LLM provider configuration."},"type":{"type":"string","enum":["openai","anthropic","google-ai","openrouter","xai"],"description":"The upstream LLM provider type configured for this record."},"workspaceId":{"type":"string","format":"uuid","description":"The workspace ID that owns the LLM provider configuration."}},"required":["createdAt","id","isRemoved","updatedAt","apiKey","description","name","referenceId","type","workspaceId"]}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"The error code."},"cta":{"type":"object","properties":{"type":{"type":"string","enum":["support-contact"]},"url":{"type":"string","format":"uri"}},"required":["type","url"],"description":"The error call-to-action."},"feedback":{"type":"object","properties":{"enUs":{"type":"string"},"esEs":{"type":"string"},"ptBr":{"type":"string"}},"description":"The error feedback."},"message":{"type":"string","description":"The error message."},"name":{"type":"string","description":"The error name."}},"required":["feedback","message","name"],"description":"The description of a known exception."}}}}}}}}}
```

## GET /api/v1/llm-providers/{id}

>

```json
{"openapi":"3.1.0","info":{"title":"Public API","version":"1.0.0"},"servers":[{"description":"API Server","url":"https://api.endless.zaia.app"}],"paths":{"/api/v1/llm-providers/{id}":{"get":{"tags":["LLM Providers"],"parameters":[{"schema":{"type":"string","format":"uuid","description":"A UUID v4 string that identifies an entity."},"required":true,"description":"A UUID v4 string that identifies an entity.","name":"id","in":"path"},{"schema":{"type":"string","description":"The API key to use for authentication. Can be created in the api keys section on the workspace settings page."},"required":true,"description":"The API key to use for authentication. Can be created in the api keys section on the workspace settings page.","name":"authorization","in":"header"}],"responses":{"200":{"description":"Retrieves an LLM provider.","content":{"application/json":{"schema":{"type":"object","properties":{"createdAt":{"type":"string","format":"date-time"},"id":{"type":"string","format":"uuid","description":"A UUID v4 string that identifies an entity."},"isRemoved":{"type":"boolean"},"updatedAt":{"type":"string","format":"date-time"},"apiKey":{"type":"string","minLength":1,"maxLength":500,"description":"The API key used to authenticate with the LLM provider."},"description":{"type":"string","nullable":true,"minLength":3,"maxLength":250,"description":"The internal description of the LLM provider configuration."},"name":{"type":"string","minLength":3,"maxLength":50,"description":"The display name of the LLM provider configuration."},"referenceId":{"type":"string","nullable":true,"format":"uuid","description":"The optional reference ID associated with the LLM provider configuration."},"type":{"type":"string","enum":["openai","anthropic","google-ai","openrouter","xai"],"description":"The upstream LLM provider type configured for this record."},"workspaceId":{"type":"string","format":"uuid","description":"The workspace ID that owns the LLM provider configuration."}},"required":["createdAt","id","isRemoved","updatedAt","apiKey","description","name","referenceId","type","workspaceId"]}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"The error code."},"cta":{"type":"object","properties":{"type":{"type":"string","enum":["support-contact"]},"url":{"type":"string","format":"uri"}},"required":["type","url"],"description":"The error call-to-action."},"feedback":{"type":"object","properties":{"enUs":{"type":"string"},"esEs":{"type":"string"},"ptBr":{"type":"string"}},"description":"The error feedback."},"message":{"type":"string","description":"The error message."},"name":{"type":"string","description":"The error name."}},"required":["feedback","message","name"],"description":"The description of a known exception."}}}},"404":{"description":"LLM provider not found.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"The error code."},"cta":{"type":"object","properties":{"type":{"type":"string","enum":["support-contact"]},"url":{"type":"string","format":"uri"}},"required":["type","url"],"description":"The error call-to-action."},"feedback":{"type":"object","properties":{"enUs":{"type":"string"},"esEs":{"type":"string"},"ptBr":{"type":"string"}},"description":"The error feedback."},"message":{"type":"string","description":"The error message."},"name":{"type":"string","description":"The error name."}},"required":["feedback","message","name"],"description":"The description of a known exception."}}}}}}}}}
```

## DELETE /api/v1/llm-providers/{id}

> Removes an LLM provider.

```json
{"openapi":"3.1.0","info":{"title":"Public API","version":"1.0.0"},"servers":[{"description":"API Server","url":"https://api.endless.zaia.app"}],"paths":{"/api/v1/llm-providers/{id}":{"delete":{"description":"Removes an LLM provider.","tags":["LLM Providers"],"parameters":[{"schema":{"type":"string","format":"uuid","description":"A UUID v4 string that identifies an entity."},"required":true,"description":"A UUID v4 string that identifies an entity.","name":"id","in":"path"},{"schema":{"type":"string","description":"The API key to use for authentication. Can be created in the api keys section on the workspace settings page."},"required":true,"description":"The API key to use for authentication. Can be created in the api keys section on the workspace settings page.","name":"authorization","in":"header"}],"responses":{"200":{"description":"The LLM provider was removed.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"An informative message for a call that has no effective result to be returned."}},"required":["message"]}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"The error code."},"cta":{"type":"object","properties":{"type":{"type":"string","enum":["support-contact"]},"url":{"type":"string","format":"uri"}},"required":["type","url"],"description":"The error call-to-action."},"feedback":{"type":"object","properties":{"enUs":{"type":"string"},"esEs":{"type":"string"},"ptBr":{"type":"string"}},"description":"The error feedback."},"message":{"type":"string","description":"The error message."},"name":{"type":"string","description":"The error name."}},"required":["feedback","message","name"],"description":"The description of a known exception."}}}},"404":{"description":"LLM provider not found.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"The error code."},"cta":{"type":"object","properties":{"type":{"type":"string","enum":["support-contact"]},"url":{"type":"string","format":"uri"}},"required":["type","url"],"description":"The error call-to-action."},"feedback":{"type":"object","properties":{"enUs":{"type":"string"},"esEs":{"type":"string"},"ptBr":{"type":"string"}},"description":"The error feedback."},"message":{"type":"string","description":"The error message."},"name":{"type":"string","description":"The error name."}},"required":["feedback","message","name"],"description":"The description of a known exception."}}}}}}}}}
```

## PATCH /api/v1/llm-providers/{id}

> Updates an LLM provider.

```json
{"openapi":"3.1.0","info":{"title":"Public API","version":"1.0.0"},"servers":[{"description":"API Server","url":"https://api.endless.zaia.app"}],"paths":{"/api/v1/llm-providers/{id}":{"patch":{"description":"Updates an LLM provider.","tags":["LLM Providers"],"parameters":[{"schema":{"type":"string","format":"uuid","description":"A UUID v4 string that identifies an entity."},"required":true,"description":"A UUID v4 string that identifies an entity.","name":"id","in":"path"},{"schema":{"type":"string","description":"The API key to use for authentication. Can be created in the api keys section on the workspace settings page."},"required":true,"description":"The API key to use for authentication. Can be created in the api keys section on the workspace settings page.","name":"authorization","in":"header"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"apiKey":{"type":"string","minLength":1,"maxLength":500,"description":"The API key used to authenticate with the LLM provider."},"description":{"type":"string","nullable":true,"minLength":3,"maxLength":250,"description":"The internal description of the LLM provider configuration."},"name":{"type":"string","minLength":3,"maxLength":50,"description":"The display name of the LLM provider configuration."},"referenceId":{"type":"string","nullable":true,"format":"uuid","description":"The optional reference ID associated with the LLM provider configuration."}}}}}},"responses":{"200":{"description":"The LLM provider was updated.","content":{"application/json":{"schema":{"type":"object","properties":{"createdAt":{"type":"string","format":"date-time"},"id":{"type":"string","format":"uuid","description":"A UUID v4 string that identifies an entity."},"isRemoved":{"type":"boolean"},"updatedAt":{"type":"string","format":"date-time"},"apiKey":{"type":"string","minLength":1,"maxLength":500,"description":"The API key used to authenticate with the LLM provider."},"description":{"type":"string","nullable":true,"minLength":3,"maxLength":250,"description":"The internal description of the LLM provider configuration."},"name":{"type":"string","minLength":3,"maxLength":50,"description":"The display name of the LLM provider configuration."},"referenceId":{"type":"string","nullable":true,"format":"uuid","description":"The optional reference ID associated with the LLM provider configuration."},"type":{"type":"string","enum":["openai","anthropic","google-ai","openrouter","xai"],"description":"The upstream LLM provider type configured for this record."},"workspaceId":{"type":"string","format":"uuid","description":"The workspace ID that owns the LLM provider configuration."}},"required":["createdAt","id","isRemoved","updatedAt","apiKey","description","name","referenceId","type","workspaceId"]}}}},"401":{"description":"Unauthorized.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"The error code."},"cta":{"type":"object","properties":{"type":{"type":"string","enum":["support-contact"]},"url":{"type":"string","format":"uri"}},"required":["type","url"],"description":"The error call-to-action."},"feedback":{"type":"object","properties":{"enUs":{"type":"string"},"esEs":{"type":"string"},"ptBr":{"type":"string"}},"description":"The error feedback."},"message":{"type":"string","description":"The error message."},"name":{"type":"string","description":"The error name."}},"required":["feedback","message","name"],"description":"The description of a known exception."}}}},"404":{"description":"LLM provider not found.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"The error code."},"cta":{"type":"object","properties":{"type":{"type":"string","enum":["support-contact"]},"url":{"type":"string","format":"uri"}},"required":["type","url"],"description":"The error call-to-action."},"feedback":{"type":"object","properties":{"enUs":{"type":"string"},"esEs":{"type":"string"},"ptBr":{"type":"string"}},"description":"The error feedback."},"message":{"type":"string","description":"The error message."},"name":{"type":"string","description":"The error name."}},"required":["feedback","message","name"],"description":"The description of a known exception."}}}}}}}}}
```