---
title: "PATCH /v1/orgs/{orgId}/byo-provider"
method: PATCH
path: "/v1/orgs/{orgId}/byo-provider"
tags: ["ByoProvider"]
---

# PATCH /v1/orgs/{orgId}/byo-provider

`PATCH /v1/orgs/{orgId}/byo-provider`

Partially updates the organization's own LLM provider. Every field is optional, including `credential`: omit it and the stored one is used. Validation runs against the merged result. Gateway validation only runs when connection details, models, or enabled state require it. A partial `tierModels` is merged over the stored tier selection.

## Path parameters

- `orgId` string, uuid, required

## Headers

- `Authorization` string

## Request body

- object
  - `baseUrl` string — HTTPS gateway base URL ending in /v1, without user information, a query, or a fragment.
  - `credential` string
  - `enabledModels` string[]
  - `tierModels` object — Tier to model, in the customer's own model names. Tessl maps each of its features to a tier; that mapping is not configurable.
    - `high` string
    - `medium` string
    - `low` string
  - `enabled` boolean

## Response `200`

Default Response

- object
  - `links` object, required
    - `self` string, uri, required
  - `data` object, required
    - `id` string, uuid, required
    - `type` 'byo-provider', required
    - `attributes` object, required
      - `baseUrl` string, required
      - `enabledModels` string[], required
      - `tierModels` object, required
        - `high` string, nullable, required
        - `medium` string, nullable, required
        - `low` string, nullable, required
      - `enabled` boolean, required
      - `orgSlug` string, required — Immutable organization slug used as the prefix for composed gateway model names.
      - `updatedAt` string, date-time, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `502` — Bad Gateway

## Changes

- **2026-08-14** `97cba54605fd` — 1 breaking, 1 warning, 2 info
  - removed the required property `data/attributes/featureDefaultModels` from the response with the `200` status
  - removed the request property `featureDefaultModels`
  - added the new optional request property `tierModels`
  - added the required property `data/attributes/tierModels` to the response with the `200` status
- **2026-08-12** `a3e84124ece4` — 1 info
  - removed the pattern `^https://.*/v1$` from the request property `baseUrl`
- **2026-08-11** `09211715bc70` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/tessl/apis/tessl-api/changes/v1/orgs/:orgId/byo-provider/patch.md)

---

[API](https://skmtc.dev/tessl/apis/tessl-api.md) · [All operations](https://skmtc.dev/tessl/apis/tessl-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tessl/tessl-api/revisions/538ff8b269b7/schema)