Skip to main content
POST
/
v2
/
builds
/
upload
Upload build
curl --request POST \
  --url https://api.comparebench.com/v2/builds/upload \
  --header 'Content-Type: application/json' \
  --cookie session= \
  --data '
{
  "Cpu": {
    "Name": "Intel Core i9-14900K",
    "FrequencyMhz": 3200,
    "PhysicalCores": 24,
    "LogicalCores": 32,
    "Socket": "LGA1700",
    "BaseClockMhz": 3200,
    "MaxClockMhz": 5800,
    "L2Kb": 32768,
    "L3Kb": 36864
  }
}
'
{
  "build": {
    "id": 5821,
    "title": "My Gaming Rig",
    "fingerprint": "abc123def456",
    "source": "yardstick",
    "freq": 3200,
    "freq_int": 3200,
    "deleted": false,
    "private": false,
    "created_ts": "2024-11-15T14:32:00Z",
    "primary": true,
    "mem_total": 34359738368,
    "gpu_driver_version": "546.33",
    "bios_version": "1302",
    "user": "JohnDoe",
    "user_id": 1042,
    "cpu": {
      "cpuid": 142,
      "make": "Intel",
      "model": "Core i9-14900K",
      "cores": 24,
      "threads": 32,
      "base_clock": 3200,
      "url_slug": "intel-core-i9-14900k"
    },
    "gpu": [
      {
        "make": "ASUS",
        "model": "ROG Strix GeForce RTX 4090",
        "frequency": 2520,
        "ram": 25769803776,
        "url_slug": "nvidia-geforce-rtx-4090"
      }
    ],
    "memory": [
      {
        "make": "Corsair",
        "model": "Vengeance DDR5-5600",
        "gigabytes": 16,
        "speed": 5600
      }
    ],
    "motherboard": {
      "make": "ASUS",
      "model": "ROG Maximus Z790 Hero"
    },
    "images": [],
    "benchmarks": [
      {
        "id": 29014,
        "result_id": 5821,
        "benchmark_type": 1,
        "benchmark_type_name": "Cinebench R23 (Multi-Core)",
        "benchmark_cpu_gpu": "cpu",
        "runs": [
          {
            "id": 48201,
            "score": 38500,
            "fps_timeseries": []
          }
        ]
      }
    ]
  },
  "created_by_user": {
    "display_name": "JohnDoe",
    "uid": 1042
  },
  "is_logged_in_user": true,
  "uid": 1042
}
Uploads a PC build with hardware specs and benchmark results from the Yardstick app. Requires authentication. All hardware field names are PascalCase to match the Yardstick desktop client’s output format.
  • If BuildID is provided and belongs to the authenticated user, that build is updated instead of creating a new one.
  • BenchmarkType values come from GET /benchmarks/types.
  • The Fingerprint is generated by Yardstick from hardware identifiers and is used to detect duplicate builds.
A 402 response means you’ve hit the build limit for your current billing tier. Upgrade to enthusiast or professional to upload more builds.

Authorizations

​
session
string
cookie
required

Session cookie set by POST /login/yardstick

Body

application/json
​
Cpu
object
required
​
SchemaVersion
integer
default:2

Yardstick schema version. Always 2 for current clients.

​
BuildID
integer | null

Existing build ID to update. Omit to create a new build.

​
Title
string
default:Yardstick Result

Display name for this build

​
Fingerprint
string | null

Unique hardware fingerprint generated by Yardstick

​
Gpus
object[]
​
Ram
object[]
​
Motherboard
object
​
Benchmarks
object[]

Response

Build created or updated

​
build
object
​
created_by_user
object
​
is_logged_in_user
boolean

True if the authenticated user is the build owner

​
uid
integer