> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Update AWS Bedrock custom model

> Updates an AWS Bedrock custom model. ARN changes are format-validated (live AWS validation lives in the dedicated validate endpoint). Configuration and metadata are spread-merged. Parameters are replaced only when the request produces a non-empty list.



## OpenAPI

````yaml patch /v2/models/aws-bedrock/{id}
openapi: 3.1.0
info:
  title: orq.ai API
  version: '2.0'
  description: orq.ai API documentation
servers:
  - url: https://api.orq.ai
security:
  - ApiKey: []
tags:
  - description: List models available through the AI Router.
    name: Models
  - name: Guardrail Rules
  - name: Policies
  - name: Routing Rules
  - name: API keys
    description: >-
      API keys authenticate programmatic access to the workspace. The unified
      key model exposes opaque tokens, per-domain access grants, and budget /
      rate-limit constraints (see ADR 0001 and ADR 0002).
  - name: Budgets
    description: >-
      Budgets govern spend, token usage, and request rate across six scopes:
      workspace, project, identity, api-key, provider, and model. A budget is
      hierarchical and defense-in-depth — every applicable budget is a hard
      gate, and the most restrictive one wins per dimension (see ADR 0007).
  - name: Documentation
    description: >-
      Search the orq.ai documentation. Proxies the workspace's query to the
      hosted docs search index.
  - name: Files
    description: File upload and retrieval operations.
  - name: Identities
    description: >-
      Identities represent end users from your system for usage and engagement
      tracking.
  - name: Projects
    description: Projects organize resources within a workspace
  - name: Skills
    description: >-
      Skills are modular instructions you can use to codify processes and
      conventions
  - name: Responses
  - description: >-
      Run agents on a cadence — cron, interval, or one-off. Minimum firing
      interval is 1 hour.
    name: Agent Schedules
  - name: Embeddings
  - name: Reporting
    description: >-
      GenAI reporting API over canonical analytics rollups. Accepts a metric
      name, time range, grain, group-by, and filters; returns a typed time
      series and optional totals.
externalDocs:
  url: https://docs.orq.ai
  description: orq.ai Documentation
paths:
  /v2/models/aws-bedrock/{id}:
    patch:
      tags:
        - Models
      summary: Update AWS Bedrock custom model
      description: >-
        Updates an AWS Bedrock custom model. ARN changes are format-validated
        (live AWS validation lives in the dedicated validate endpoint).
        Configuration and metadata are spread-merged. Parameters are replaced
        only when the request produces a non-empty list.
      operationId: ModelUpdateAwsBedrock
      parameters:
        - description: The ID of the model
          in: path
          name: id
          required: true
          schema:
            description: The ID of the model
            type: string
      requestBody:
        content:
          application/json:
            schema:
              additionalProperties: false
              properties:
                assume_role_arn:
                  type: string
                assume_role_external_id:
                  type: string
                description:
                  type: string
                display_name:
                  maxLength: 128
                  type: string
                has_reasoning:
                  type: boolean
                input_cost:
                  type: number
                  format: double
                max_tokens:
                  format: int64
                  type: integer
                model_developer:
                  type: string
                model_family:
                  type: string
                model_id:
                  type: string
                model_type:
                  type: string
                output_cost:
                  type: number
                  format: double
                region:
                  type: string
                supports_adaptive_reasoning:
                  type: boolean
                supports_extended_thinking:
                  type: boolean
                supports_json_mode:
                  type: boolean
                supports_json_schema:
                  type: boolean
                supports_strict_tool:
                  type: boolean
                supports_tool_calling:
                  type: boolean
                supports_vision:
                  type: boolean
                temperature:
                  type: number
                  format: double
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  configuration:
                    $ref: '#/components/schemas/ModelConfigurationResponse'
                  created:
                    format: date-time
                    type: string
                  description:
                    type:
                      - string
                      - 'null'
                  display_name:
                    type: string
                  docs_url:
                    type:
                      - string
                      - 'null'
                  enabled:
                    type: boolean
                  enabled_for_endpoints:
                    type: boolean
                  enabled_for_playground:
                    type: boolean
                  has_cpu_pricing:
                    type: boolean
                  has_functions:
                    type: boolean
                  id:
                    type: string
                  input_cost:
                    format: double
                    type:
                      - number
                      - 'null'
                  input_currency:
                    type: string
                  is_active:
                    type: boolean
                  metadata:
                    $ref: '#/components/schemas/ModelMetadata'
                  model_developer:
                    type: string
                  model_family:
                    type: string
                  model_id:
                    type: string
                  model_type:
                    type: string
                  output_cost:
                    format: double
                    type:
                      - number
                      - 'null'
                  output_currency:
                    type: string
                  owner:
                    type: string
                  parameters:
                    items:
                      $ref: '#/components/schemas/ModelParameterDocument'
                    type:
                      - array
                      - 'null'
                  pricing_url:
                    type:
                      - string
                      - 'null'
                  provider:
                    type: string
                  refId:
                    type: string
                  updated:
                    format: date-time
                    type: string
                required:
                  - id
                  - created
                  - updated
                  - display_name
                  - model_id
                  - is_active
                  - provider
                  - owner
                  - input_cost
                  - input_currency
                  - output_cost
                  - output_currency
                  - description
                  - pricing_url
                  - docs_url
                  - model_type
                  - has_functions
                  - has_cpu_pricing
                  - enabled_for_playground
                  - enabled_for_endpoints
                  - configuration
                  - metadata
                  - parameters
                  - enabled
                  - refId
                type: object
          description: AWS Bedrock model updated successfully
        '400':
          description: Invalid ARN format or request
        '404':
          description: Model not found or not accessible in this workspace
      x-code-samples:
        - label: Node.js
          lang: typescript
          source: |-
            await orq.models.updateAwsBedrock({
              id: "019d...",
              display_name: "Updated name",
              region: "us-east-1",
            });
components:
  schemas:
    ModelConfigurationResponse:
      additionalProperties: false
      properties:
        api_key_env:
          type: string
        api_version:
          type: string
        auth_mode:
          type: string
        auth_type:
          type: string
        base_url:
          type: string
        deployment_name:
          type: string
        endpoint:
          type: string
        inference_profile_arn:
          type: string
        integration_id:
          type: string
        is_openai_compatible:
          type: boolean
        is_tuned_model:
          type: boolean
        location:
          type: string
        project_id:
          type: string
        provider:
          type: string
        region:
          type: string
        should_use_beta_features:
          type: boolean
        subtype:
          type: string
        workspace_id:
          type: string
      required:
        - provider
      type: object
    ModelMetadata:
      additionalProperties: false
      properties:
        allowed_passthrough_parameters:
          items:
            type: string
          type:
            - array
            - 'null'
        autorouter:
          $ref: '#/components/schemas/AutoRouterConfig'
        cached_image_input_cost:
          type: number
          format: double
        cached_input_cost:
          type: number
          format: double
        chain_of_thought:
          type: boolean
        context_length:
          format: int64
          type: integer
        context_window:
          format: int64
          type: integer
        cost_efficiency_rating:
          format: int64
          type: integer
        cost_per_image:
          type: number
          format: double
        deprecation_date:
          type: string
        embedding_dimensions:
          format: int64
          type: integer
        extended_context_pricing_mode:
          type: string
        extended_context_threshold:
          format: int64
          type: integer
        generate_audio:
          type: boolean
        image_input_cost:
          type: number
          format: double
        image_output_cost:
          type: number
          format: double
        image_token_cost:
          type: number
          format: double
        intelligence_rating:
          format: int64
          type: integer
        is_private:
          type: boolean
        is_realtime:
          type: boolean
        knowledge_cutoff:
          type: string
        max_images_per_request:
          format: int64
          type: integer
        max_input_tokens:
          format: int64
          type: integer
        max_output_tokens:
          format: int64
          type: integer
        million_searches_cost:
          type: number
          format: double
        million_tokens_above_128k_cache_read_cost:
          type: number
          format: double
        million_tokens_above_128k_cache_write_cost:
          type: number
          format: double
        million_tokens_above_128k_input_cost:
          type: number
          format: double
        million_tokens_above_128k_output_cost:
          type: number
          format: double
        million_tokens_above_200k_cache_read_cost:
          type: number
          format: double
        million_tokens_above_200k_cache_write_cost:
          type: number
          format: double
        million_tokens_above_200k_input_cost:
          type: number
          format: double
        million_tokens_above_200k_output_cost:
          type: number
          format: double
        million_tokens_audio_input_cost:
          type: number
          format: double
        million_tokens_audio_output_cost:
          type: number
          format: double
        million_tokens_batches_input_cost:
          type: number
          format: double
        million_tokens_batches_output_cost:
          type: number
          format: double
        million_tokens_cache_read_cost:
          type: number
          format: double
        million_tokens_cache_write_1h_cost:
          type: number
          format: double
        million_tokens_cache_write_5m_cost:
          type: number
          format: double
        million_tokens_cache_write_cost:
          type: number
          format: double
        million_tokens_input_cost:
          type: number
          format: double
        million_tokens_output_cost:
          type: number
          format: double
        million_tokens_reasoning_cost:
          type: number
          format: double
        multilingual:
          type: boolean
        offline:
          type: boolean
        per_video_second_cost:
          type: number
          format: double
        per_video_second_cost_1080p:
          type: number
          format: double
        pricing:
          $ref: '#/components/schemas/Pricing'
        reasoning_cost:
          type: number
          format: double
        reasoning_tokens:
          format: int64
          type: integer
        region:
          type: string
        speed_rating:
          format: int64
          type: integer
        supported_video_aspect_ratios:
          items:
            type: string
          type:
            - array
            - 'null'
        supported_video_durations:
          items:
            format: int64
            type: integer
          type:
            - array
            - 'null'
        supported_video_frame_images:
          items:
            type: string
          type:
            - array
            - 'null'
        supported_video_resolutions:
          items:
            type: string
          type:
            - array
            - 'null'
        supported_video_sizes:
          items:
            type: string
          type:
            - array
            - 'null'
        supports_adaptive_reasoning:
          type: boolean
        supports_audio_input:
          type: boolean
        supports_audio_output:
          type: boolean
        supports_b64_json_response_format:
          type: boolean
        supports_batch_api:
          type: boolean
        supports_cache_control:
          type: boolean
        supports_code_execution:
          type: boolean
        supports_commercial_use:
          type: boolean
        supports_computer_use:
          type: boolean
        supports_developer_message:
          type: boolean
        supports_direct_cost:
          type: boolean
        supports_distillation:
          type: boolean
        supports_extended_thinking:
          type: boolean
        supports_fine_tuning:
          type: boolean
        supports_image_edit:
          type: boolean
        supports_image_input:
          type: boolean
        supports_image_output:
          type: boolean
        supports_images:
          type: boolean
        supports_json_mode_response_format:
          type: boolean
        supports_json_schema_response_format:
          type: boolean
        supports_max_completion_tokens:
          type: boolean
        supports_openai_sdk:
          type: boolean
        supports_parallel_tool_calls:
          type: boolean
        supports_pdf_input:
          type: boolean
        supports_prompt_caching:
          type: boolean
        supports_reasoning:
          type: boolean
        supports_reasoning_effort_default:
          type: boolean
        supports_reasoning_effort_high:
          type: boolean
        supports_reasoning_effort_low:
          type: boolean
        supports_reasoning_effort_medium:
          type: boolean
        supports_reasoning_effort_minimal:
          type: boolean
        supports_reasoning_effort_none:
          type: boolean
        supports_reasoning_effort_xhigh:
          type: boolean
        supports_responses_api:
          type: boolean
        supports_sampling_params:
          type: boolean
        supports_streaming:
          type: boolean
        supports_strict_tool:
          type: boolean
        supports_structured_outputs:
          type: boolean
        supports_system_message:
          type: boolean
        supports_text:
          type: boolean
        supports_text_input:
          type: boolean
        supports_text_output:
          type: boolean
        supports_tool_calling:
          type: boolean
        supports_tool_choice:
          type: boolean
        supports_url_context:
          type: boolean
        supports_url_response_format:
          type: boolean
        supports_video_input:
          type: boolean
        supports_video_output:
          type: boolean
        supports_video_seed:
          type: boolean
        supports_vision:
          type: boolean
        supports_web_search:
          type: boolean
        supports_zdr:
          type: boolean
        thinking_enforced:
          type: boolean
      required:
        - is_private
      type: object
    ModelParameterDocument:
      additionalProperties: false
      properties:
        config:
          type: object
          additionalProperties: {}
        description:
          type:
            - string
            - 'null'
        hints:
          type: string
        id:
          type: string
        is_active:
          type: boolean
        name:
          type: string
        parameter:
          type: string
        parameter_type:
          type: string
        position:
          format: int64
          type: integer
      required:
        - id
        - name
        - parameter
        - description
        - config
        - parameter_type
        - is_active
      type: object
    AutoRouterConfig:
      additionalProperties: false
      properties:
        economical_model:
          type: string
        id:
          type: string
        profile:
          type: string
        strong_model:
          type: string
        version:
          type: string
      type: object
    Pricing:
      additionalProperties: false
      properties:
        cache_read:
          $ref: '#/components/schemas/Price'
        cache_write_1h:
          $ref: '#/components/schemas/Price'
        cache_write_5m:
          $ref: '#/components/schemas/Price'
        input:
          $ref: '#/components/schemas/Price'
        output:
          $ref: '#/components/schemas/Price'
        reasoning:
          $ref: '#/components/schemas/Price'
        variants:
          items:
            $ref: '#/components/schemas/PricingVariant'
          type:
            - array
            - 'null'
      type: object
    Price:
      additionalProperties: false
      properties:
        cost:
          type: number
          format: double
        currency:
          type: string
        per:
          format: int64
          type: integer
        unit:
          type: string
      required:
        - cost
        - currency
        - unit
        - per
      type: object
    PricingVariant:
      additionalProperties: false
      properties:
        cache_read:
          $ref: '#/components/schemas/Price'
        cache_write_1h:
          $ref: '#/components/schemas/Price'
        cache_write_5m:
          $ref: '#/components/schemas/Price'
        input:
          $ref: '#/components/schemas/Price'
        output:
          $ref: '#/components/schemas/Price'
        reasoning:
          $ref: '#/components/schemas/Price'
        when:
          type: string
      required:
        - when
      type: object
  securitySchemes:
    ApiKey:
      type: http
      scheme: bearer
      bearerFormat: JWT

````