Set an agent cost catalog override

curl --request PUT \
  --url https://api.hyperline.co/v1/ai/billing/cost-catalog/overrides \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "provider": "anthropic",
  "model": "claude-sonnet-5",
  "input_per_m_tokens": "3",
  "output_per_m_tokens": "15",
  "cached_input_per_m_tokens": "0.3",
  "cache_write_per_m_tokens": "3.75",
  "dimensions": [
    {
      "key": "cached_input_tokens",
      "rate": "0.3",
      "per": "1m"
    }
  ]
}
'

import requests

url = "https://api.hyperline.co/v1/ai/billing/cost-catalog/overrides"

payload = {
    "provider": "anthropic",
    "model": "claude-sonnet-5",
    "input_per_m_tokens": "3",
    "output_per_m_tokens": "15",
    "cached_input_per_m_tokens": "0.3",
    "cache_write_per_m_tokens": "3.75",
    "dimensions": [
        {
            "key": "cached_input_tokens",
            "rate": "0.3",
            "per": "1m"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    provider: 'anthropic',
    model: 'claude-sonnet-5',
    input_per_m_tokens: '3',
    output_per_m_tokens: '15',
    cached_input_per_m_tokens: '0.3',
    cache_write_per_m_tokens: '3.75',
    dimensions: [{key: 'cached_input_tokens', rate: '0.3', per: '1m'}]
  })
};

fetch('https://api.hyperline.co/v1/ai/billing/cost-catalog/overrides', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hyperline.co/v1/ai/billing/cost-catalog/overrides",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'provider' => 'anthropic',
    'model' => 'claude-sonnet-5',
    'input_per_m_tokens' => '3',
    'output_per_m_tokens' => '15',
    'cached_input_per_m_tokens' => '0.3',
    'cache_write_per_m_tokens' => '3.75',
    'dimensions' => [
        [
                'key' => 'cached_input_tokens',
                'rate' => '0.3',
                'per' => '1m'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hyperline.co/v1/ai/billing/cost-catalog/overrides"

	payload := strings.NewReader("{\n  \"provider\": \"anthropic\",\n  \"model\": \"claude-sonnet-5\",\n  \"input_per_m_tokens\": \"3\",\n  \"output_per_m_tokens\": \"15\",\n  \"cached_input_per_m_tokens\": \"0.3\",\n  \"cache_write_per_m_tokens\": \"3.75\",\n  \"dimensions\": [\n    {\n      \"key\": \"cached_input_tokens\",\n      \"rate\": \"0.3\",\n      \"per\": \"1m\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.hyperline.co/v1/ai/billing/cost-catalog/overrides")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"provider\": \"anthropic\",\n  \"model\": \"claude-sonnet-5\",\n  \"input_per_m_tokens\": \"3\",\n  \"output_per_m_tokens\": \"15\",\n  \"cached_input_per_m_tokens\": \"0.3\",\n  \"cache_write_per_m_tokens\": \"3.75\",\n  \"dimensions\": [\n    {\n      \"key\": \"cached_input_tokens\",\n      \"rate\": \"0.3\",\n      \"per\": \"1m\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hyperline.co/v1/ai/billing/cost-catalog/overrides")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"provider\": \"anthropic\",\n  \"model\": \"claude-sonnet-5\",\n  \"input_per_m_tokens\": \"3\",\n  \"output_per_m_tokens\": \"15\",\n  \"cached_input_per_m_tokens\": \"0.3\",\n  \"cache_write_per_m_tokens\": \"3.75\",\n  \"dimensions\": [\n    {\n      \"key\": \"cached_input_tokens\",\n      \"rate\": \"0.3\",\n      \"per\": \"1m\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "provider": "anthropic",
  "model": "claude-sonnet-5",
  "aliases": [
    "claude-sonnet-5-latest"
  ],
  "input_per_m_tokens": "3",
  "output_per_m_tokens": "15",
  "cached_input_per_m_tokens": "0.3",
  "cache_write_per_m_tokens": "3.75",
  "dimensions": [
    {
      "key": "cached_input_tokens",
      "rate": "0.3",
      "per": "1m"
    }
  ],
  "effective_from": "2026-09-01T00:00:00Z",
  "source": "official",
  "custom_item_id": null,
  "override": null
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

AI > Billing

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.

PUT

billing

cost-catalog

overrides

Set an agent cost catalog override

curl --request PUT \
  --url https://api.hyperline.co/v1/ai/billing/cost-catalog/overrides \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "provider": "anthropic",
  "model": "claude-sonnet-5",
  "input_per_m_tokens": "3",
  "output_per_m_tokens": "15",
  "cached_input_per_m_tokens": "0.3",
  "cache_write_per_m_tokens": "3.75",
  "dimensions": [
    {
      "key": "cached_input_tokens",
      "rate": "0.3",
      "per": "1m"
    }
  ]
}
'

import requests

url = "https://api.hyperline.co/v1/ai/billing/cost-catalog/overrides"

payload = {
    "provider": "anthropic",
    "model": "claude-sonnet-5",
    "input_per_m_tokens": "3",
    "output_per_m_tokens": "15",
    "cached_input_per_m_tokens": "0.3",
    "cache_write_per_m_tokens": "3.75",
    "dimensions": [
        {
            "key": "cached_input_tokens",
            "rate": "0.3",
            "per": "1m"
        }
    ]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    provider: 'anthropic',
    model: 'claude-sonnet-5',
    input_per_m_tokens: '3',
    output_per_m_tokens: '15',
    cached_input_per_m_tokens: '0.3',
    cache_write_per_m_tokens: '3.75',
    dimensions: [{key: 'cached_input_tokens', rate: '0.3', per: '1m'}]
  })
};

fetch('https://api.hyperline.co/v1/ai/billing/cost-catalog/overrides', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hyperline.co/v1/ai/billing/cost-catalog/overrides",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'provider' => 'anthropic',
    'model' => 'claude-sonnet-5',
    'input_per_m_tokens' => '3',
    'output_per_m_tokens' => '15',
    'cached_input_per_m_tokens' => '0.3',
    'cache_write_per_m_tokens' => '3.75',
    'dimensions' => [
        [
                'key' => 'cached_input_tokens',
                'rate' => '0.3',
                'per' => '1m'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hyperline.co/v1/ai/billing/cost-catalog/overrides"

	payload := strings.NewReader("{\n  \"provider\": \"anthropic\",\n  \"model\": \"claude-sonnet-5\",\n  \"input_per_m_tokens\": \"3\",\n  \"output_per_m_tokens\": \"15\",\n  \"cached_input_per_m_tokens\": \"0.3\",\n  \"cache_write_per_m_tokens\": \"3.75\",\n  \"dimensions\": [\n    {\n      \"key\": \"cached_input_tokens\",\n      \"rate\": \"0.3\",\n      \"per\": \"1m\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.hyperline.co/v1/ai/billing/cost-catalog/overrides")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"provider\": \"anthropic\",\n  \"model\": \"claude-sonnet-5\",\n  \"input_per_m_tokens\": \"3\",\n  \"output_per_m_tokens\": \"15\",\n  \"cached_input_per_m_tokens\": \"0.3\",\n  \"cache_write_per_m_tokens\": \"3.75\",\n  \"dimensions\": [\n    {\n      \"key\": \"cached_input_tokens\",\n      \"rate\": \"0.3\",\n      \"per\": \"1m\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hyperline.co/v1/ai/billing/cost-catalog/overrides")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"provider\": \"anthropic\",\n  \"model\": \"claude-sonnet-5\",\n  \"input_per_m_tokens\": \"3\",\n  \"output_per_m_tokens\": \"15\",\n  \"cached_input_per_m_tokens\": \"0.3\",\n  \"cache_write_per_m_tokens\": \"3.75\",\n  \"dimensions\": [\n    {\n      \"key\": \"cached_input_tokens\",\n      \"rate\": \"0.3\",\n      \"per\": \"1m\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "provider": "anthropic",
  "model": "claude-sonnet-5",
  "aliases": [
    "claude-sonnet-5-latest"
  ],
  "input_per_m_tokens": "3",
  "output_per_m_tokens": "15",
  "cached_input_per_m_tokens": "0.3",
  "cache_write_per_m_tokens": "3.75",
  "dimensions": [
    {
      "key": "cached_input_tokens",
      "rate": "0.3",
      "per": "1m"
    }
  ],
  "effective_from": "2026-09-01T00:00:00Z",
  "source": "official",
  "custom_item_id": null,
  "override": null
}

{
  "message": "<string>"
}

{
  "message": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Model price override payload

provider

string

required

AI model provider, or the vendor of a custom cost item. This is not an integration connection.

Minimum string length: 1

Example:

"anthropic"

model

string

required

Model identifier, or custom item identifier. Null on wildcard pricing rows.

Minimum string length: 1

Example:

"claude-sonnet-5"

input_per_m_tokens

string

required

Provider cost in USD per million input tokens, as an exact decimal string.

Maximum string length: 40

Pattern: ^\d+(\.\d+)?$

Example:

"3"

output_per_m_tokens

string

required

Provider cost in USD per million output tokens, as an exact decimal string.

Maximum string length: 40

Pattern: ^\d+(\.\d+)?$

Example:

"15"

cached_input_per_m_tokens

string

Provider cost in USD per million cached input tokens, as an exact decimal string.

Maximum string length: 40

Pattern: ^\d+(\.\d+)?$

Example:

"0.3"

cache_write_per_m_tokens

string

Provider cost in USD per million cache write tokens, as an exact decimal string.

Maximum string length: 40

Pattern: ^\d+(\.\d+)?$

Example:

"3.75"

dimensions

object[]

Additional billable dimensions; each key matches a usage_extra key and rates use the owning card's units or USD for cost-catalog dimensions.

Show child attributes

Example:

[
  {
    "key": "cached_input_tokens",
    "rate": "0.3",
    "per": "1m"
  }
]

Response

provider

string

required

AI model provider, or the vendor of a custom cost item. This is not an integration connection.

Example:

"anthropic"

model

string

required

Model identifier, or custom item identifier. Null on wildcard pricing rows.

Example:

"claude-sonnet-5"

aliases

string[]

required

Alternative model names recognized by the cost catalog.

Example:

["claude-sonnet-5-latest"]

input_per_m_tokens

string

required

Provider cost in USD per million input tokens, as an exact decimal string.

Pattern: ^-?\d+(\.\d+)?(e[+-]?\d+)?$/i

Example:

"3"

output_per_m_tokens

string

required

Provider cost in USD per million output tokens, as an exact decimal string.

Pattern: ^-?\d+(\.\d+)?(e[+-]?\d+)?$/i

Example:

"15"

cached_input_per_m_tokens

string

required

Provider cost in USD per million cached input tokens, as an exact decimal string.

Pattern: ^-?\d+(\.\d+)?(e[+-]?\d+)?$/i

Example:

"0.3"

cache_write_per_m_tokens

string

required

Provider cost in USD per million cache write tokens, as an exact decimal string.

Pattern: ^-?\d+(\.\d+)?(e[+-]?\d+)?$/i

Example:

"3.75"

dimensions

object[]

required

Additional billable dimensions; each key matches a usage_extra key and rates use the owning card's units or USD for cost-catalog dimensions.

Show child attributes

Example:

[
  {
    "key": "cached_input_tokens",
    "rate": "0.3",
    "per": "1m"
  }
]

effective_from

string<date-time>

required

Time the price takes effect, as a UTC ISO 8601 timestamp.

Example:

"2026-09-01T00:00:00Z"

source

enum<string>

required

Source of the model or item cost.

official: Official model price registry.
override: Negotiated workspace cost override.
custom: Workspace-defined cost item.
unlisted: Observed usage without catalog pricing.

Available options:

official,

override,

custom,

unlisted

Example:

"official"

custom_item_id

string | null

required

Custom cost-item identifier used to delete the item; null for registry models.

Example:

null

override

object | null

required

Negotiated workspace cost override, or null when using registry rates.

Show child attributes

Example:

null

⌘I