Error format
Errors return a JSON body with anerror label and a human-readable message:
Status codes
Common errors
401: Missing key
401: Invalid or revoked key
403: Premium grain or dataset
A Premium (sk_prem_) key asking for a Full-only surface is refused rather than silently emptied:
403: Cannot mint a key
Trial, Premium, and Full own grants can mint keys. A member of a Full organization with no own grant can mint an unstampedsk_live_ key. A trial or Premium organization floor, with no own grant, cannot. POST /api/create-api-key then returns:
400: Unknown GPU
400: Missing required parameter
404: No data
Endpoints that return the nearest record, such as
/api/gpu/{gpuName}/history, won’t 404 for an out-of-range timestamp. They return the closest match and report the gap in time_difference.
