ProviderSelection

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/bithuman-ai/json-schema/bithuman-ai-provider-selection-schema.json",
  "title": "ProviderSelection",
  "description": "Which provider one capability uses. `\"default\"` is the platform's own provider; the object form points the capability at an entry you registered with `PUT /v2/{user_id}/providers`.",
  "x-generated": "2026-10-29",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/bithuman-ai-openapi.yaml#/components/schemas/ProviderSelection",
  "oneOf": [
    {
      "type": "string",
      "enum": [
        "default"
      ]
    },
    {
      "type": "object",
      "required": [
        "mode"
      ],
      "properties": {
        "mode": {
          "type": "string",
          "enum": [
            "default",
            "custom"
          ]
        },
        "provider_id": {
          "type": "string",
          "description": "Required when `mode` is `custom`: the `id` of one of your registered provider entries. `providerId` is accepted as a spelling of the same field. An id this account has not registered is refused `400 VALIDATION_ERROR`."
        }
      }
    }
  ]
}