Versions
In addition to the authorization header, all requests must also include a Public-Api-Version header:
Public-Api-Version: VERSIONVersions in the Grain API are used to introduce and/or deprecate both endpoints and fields.
Status
Each version has a status describing its state in the lifecycle.
| Status | |
|---|---|
current |
Current Version. New features and endpoints are added to this version only. |
deprecated |
Still live, but will move to sunsetting. |
sunsetting |
Will be sunset on the specified date. Rate-limits to this version will be gradually reduced. |
retired |
No longer supported, requests using this version will error. |
Available Versions
| Version | Status |
|---|---|
| 2026-10-01 | current |
| 2025-10-31 | deprecated |
Changelog
2026-10-01
- Added:
- List Uploads
POST /_/public-api/v2/uploads - Get Upload
POST /_/public-api/v2/uploads/:upload_id - Create Upload
POST /_/public-api/v2/uploads/create - Update Upload
PATCH /_/public-api/v2/uploads/:upload_id - Promote Upload
POST /_/public-api/v2/uploads/:upload_id/promote - Token Info
GET /_/public-api/v2/token-info
- List Uploads
- Removed:
- Upload Recording
POST /_/public-api/v2/recordings/upload upload_statushook type
- Upload Recording
2025-10-31
- First Version