---
title: "Report Gpu Usage"
method: POST
path: "/worker/workflow/{workflow_id}/gpu_usage"
tags: ["worker"]
---

# Report Gpu Usage

`POST /worker/workflow/{workflow_id}/gpu_usage`

## Request

- Base URL: `https://api.rowansci.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.rowansci.com/worker/workflow/{workflow_id}/gpu_usage`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/rowansci/apis/eyrie/docs/worker/workflow/:workflow_id/gpu_usage/post.ts> (a function with typed inputs; its response is checked against the schema)

Persist and bill cumulative GPU usage for a workflow attempt.

## Path parameters

- `workflow_id` integer, required

## Request body

- WorkerGPUUsage: Cumulative GPU-seconds for one claimed workflow attempt.
  - `started_at` string, date-time, required
  - `gpu_seconds` number, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-14** `bba6e51b28bb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rowansci/apis/eyrie/changes/worker/workflow/:workflow_id/gpu_usage/post.md)

---

[API](https://skmtc.dev/rowansci/apis/eyrie.md) - [All operations](https://skmtc.dev/rowansci/apis/eyrie/llms.txt) - [OpenAPI document](https://skmtc.dev/rowansci/apis/eyrie/revisions/11711cda3e1b?raw)