Brands API — sponsors and partner management

The Brands API lets you manage the sponsors and commercial partners that appear alongside PitPath Chrono events. A brand carries a name, a website URL, and a logo — which can be stored as a CDN asset or referenced by an external URL. GET endpoints are public. Creating or updating records requires a CRUD+ role.

Brand object

string (UUID)

required

Unique identifier for the brand.

string

required

Brand name (2–120 characters).

string

required

Brand website URL (max 255 characters).

string

required

CDN asset key or external URL for the brand logo (max 255 characters).

number

Percentage by which to scale the logo when displayed alongside other brand logos. Defaults to 100.

boolean

required

When true, the logo field is treated as an external URL rather than a CDN asset key.

string (ISO 8601)

Timestamp when the brand was created.

string (ISO 8601)

Timestamp of the most recent update.

List brands

Public endpoint — no authentication required.

Returns all brands as an unordered list.

GET /api/v1/brands

Example request

cURL

curl https://chrono.pitpath.de/api/v1/brands \
  -H "X-API-Key: YOUR_API_KEY"

Example response

200

[
  {
    "id": "a9b8c7d6-e5f4-3210-9876-fedcba543210",
    "name": "Fanatec",
    "websiteUrl": "https://fanatec.com",
    "logo": "BRAND/fanatec.svg",
    "logoScalePercent": 90,
    "logoUrl": false,
    "createdAt": "2024-03-01T09:00:00Z",
    "updatedAt": "2024-03-01T09:00:00Z"
  }
]

List brands (paged)

Public endpoint — no authentication required.

Returns brands in a paginated response. Default page size is 20, sorted by name.

GET /api/v1/brands/paged

Query parameters

number

default:"0"

Zero-based page index.

number

default:"20"

Number of items per page.

string

default:"name"

Field and direction, e.g. name,asc.

Example request

cURL

curl "https://chrono.pitpath.de/api/v1/brands/paged?page=0&size=20&sort=name,asc" \
  -H "X-API-Key: YOUR_API_KEY"

Get a brand

Public endpoint — no authentication required.

Returns a single brand by its UUID.

GET /api/v1/brands/{brandId}

Path parameters

string (UUID)

required

The UUID of the brand to retrieve.

Example request

cURL

curl https://chrono.pitpath.de/api/v1/brands/a9b8c7d6-e5f4-3210-9876-fedcba543210 \
  -H "X-API-Key: YOUR_API_KEY"

Create a brand

Requires CRUD+ role.

Creates a new brand. Returns 201 Created with a Location header pointing to the new resource.

POST /api/v1/brands

Request body

string

required

Brand name (2–120 characters).

string

required

Brand website URL (max 255 characters).

string

required

CDN asset key or external URL for the brand logo (max 255 characters). Set logoUrl to true if you are supplying an external URL rather than a CDN key.

number

Scaling percentage for the logo in composite displays. Defaults to 100.

boolean

Set to true when logo is an external URL instead of a CDN asset key. Defaults to false.

Example request

cURL

curl -X POST https://chrono.pitpath.de/api/v1/brands \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Fanatec",
    "websiteUrl": "https://fanatec.com",
    "logo": "BRAND/fanatec.svg",
    "logoScalePercentage": 90,
    "logoUrl": false
  }'

Example response

201

{
  "id": "a9b8c7d6-e5f4-3210-9876-fedcba543210",
  "name": "Fanatec",
  "websiteUrl": "https://fanatec.com",
  "logo": "BRAND/fanatec.svg",
  "logoScalePercent": 90,
  "logoUrl": false,
  "createdAt": "2024-03-01T09:00:00Z",
  "updatedAt": "2024-03-01T09:00:00Z"
}

Update a brand

Requires CRUD+ role.

Partially updates an existing brand. Only the fields you include are changed.

PATCH /api/v1/brands/{brandId}

Path parameters

string (UUID)

required

The UUID of the brand to update.

Request body

string

New brand name (2–120 characters).

string

New website URL (max 255 characters).

string

New CDN asset key or external URL (max 255 characters).

number

New scaling percentage for the logo.

boolean

Update whether logo is an external URL (true) or a CDN key (false).

Example request

cURL

curl -X PATCH https://chrono.pitpath.de/api/v1/brands/a9b8c7d6-e5f4-3210-9876-fedcba543210 \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"logoScalePercentage": 80}'

Example response

200

{
  "id": "a9b8c7d6-e5f4-3210-9876-fedcba543210",
  "name": "Fanatec",
  "websiteUrl": "https://fanatec.com",
  "logo": "BRAND/fanatec.svg",
  "logoScalePercent": 80,
  "logoUrl": false,
  "createdAt": "2024-03-01T09:00:00Z",
  "updatedAt": "2024-07-15T11:30:00Z"
}

Overview

Endpoints

Brands API — sponsors and partner management

Brand object

List brands

List brands (paged)

Get a brand

Create a brand

Update a brand

​Brand object

​List brands

​List brands (paged)

​Get a brand

​Create a brand

​Update a brand

Brand object

List brands

List brands (paged)

Get a brand

Create a brand

Update a brand