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

# Set an agent cost catalog override

> State the workspace's negotiated rate for a model the global registry already prices — the discount you actually pay, not the list price. Token rates are USD per million tokens and `dimensions` carries whatever else that model bills. Any open override for the pair is closed as of now and this one takes effect immediately; calls already priced keep the rate they were priced with. An alias resolves to its canonical model, so naming a spelling the registry collapsed writes the surviving model's override. A (provider, model) pair the registry does not know is refused — that is a custom cost item, created through the items endpoint.



## OpenAPI

````yaml put /v1/agents/cost-catalog/overrides
openapi: 3.1.0
info:
  title: Hyperline API
  version: 0.0.0
servers:
  - url: https://api.hyperline.co
  - url: https://sandbox.api.hyperline.co
security: []
paths:
  /v1/agents/cost-catalog/overrides:
    put:
      tags:
        - Agents
      summary: Set an agent cost catalog override
      description: >-
        State the workspace's negotiated rate for a model the global registry
        already prices — the discount you actually pay, not the list price.
        Token rates are USD per million tokens and `dimensions` carries whatever
        else that model bills. Any open override for the pair is closed as of
        now and this one takes effect immediately; calls already priced keep the
        rate they were priced with. An alias resolves to its canonical model, so
        naming a spelling the registry collapsed writes the surviving model's
        override. A (provider, model) pair the registry does not know is refused
        — that is a custom cost item, created through the items endpoint.
      operationId: upsertAgentCostCatalogOverride
      requestBody:
        description: Model price override payload
        content:
          application/json:
            schema:
              type: object
              properties:
                provider:
                  type: string
                  minLength: 1
                model:
                  type: string
                  minLength: 1
                input_per_m_tokens:
                  type: string
                  pattern: ^\d+(\.\d+)?$
                output_per_m_tokens:
                  type: string
                  pattern: ^\d+(\.\d+)?$
                cached_input_per_m_tokens:
                  type: string
                  pattern: ^\d+(\.\d+)?$
                cache_write_per_m_tokens:
                  type: string
                  pattern: ^\d+(\.\d+)?$
                dimensions:
                  type: array
                  items:
                    type: object
                    properties:
                      key:
                        type: string
                        pattern: ^[a-z0-9_.]{1,64}$
                      rate:
                        type: string
                        pattern: ^\d+(\.\d+)?$
                      per:
                        type: string
                        enum:
                          - 1m
                          - 1k
                          - unit
                    required:
                      - key
                      - rate
                      - per
              required:
                - provider
                - model
                - input_per_m_tokens
                - output_per_m_tokens
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  provider:
                    type: string
                  model:
                    type: string
                  aliases:
                    type: array
                    items:
                      type: string
                  input_per_m_tokens:
                    type: string
                  output_per_m_tokens:
                    type: string
                  cached_input_per_m_tokens:
                    type: string
                  cache_write_per_m_tokens:
                    type: string
                  dimensions:
                    type: array
                    items:
                      type: object
                      properties:
                        key:
                          type: string
                        rate:
                          type: string
                        per:
                          type: string
                          enum:
                            - 1m
                            - 1k
                            - unit
                      required:
                        - key
                        - rate
                        - per
                  effective_from:
                    type: string
                  source:
                    type: string
                  custom_item_id:
                    type:
                      - string
                      - 'null'
                  override:
                    type:
                      - object
                      - 'null'
                    properties:
                      id:
                        type: string
                      input_per_m_tokens:
                        type: string
                      output_per_m_tokens:
                        type: string
                      cached_input_per_m_tokens:
                        type:
                          - string
                          - 'null'
                      cache_write_per_m_tokens:
                        type:
                          - string
                          - 'null'
                      dimensions:
                        type: array
                        items:
                          type: object
                          properties:
                            key:
                              type: string
                            rate:
                              type: string
                            per:
                              type: string
                              enum:
                                - 1m
                                - 1k
                                - unit
                          required:
                            - key
                            - rate
                            - per
                      effective_from:
                        type: string
                    required:
                      - id
                      - input_per_m_tokens
                      - output_per_m_tokens
                      - cached_input_per_m_tokens
                      - cache_write_per_m_tokens
                      - effective_from
                required:
                  - provider
                  - model
                  - aliases
                  - input_per_m_tokens
                  - output_per_m_tokens
                  - cached_input_per_m_tokens
                  - cache_write_per_m_tokens
                  - dimensions
                  - effective_from
                  - source
                  - custom_item_id
                  - override
      security:
        - bearer: []
components:
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT

````