remix-api-reference
OpenAPI-first endpoint reference for Remix game publishing REST routes
How do I install this agent skill?
npx skills add https://github.com/farworld-labs/remix-skills --skill remix-api-referenceIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill facilitates interaction with the Remix game publishing API by fetching an external OpenAPI specification. This design introduces a surface for indirect prompt injection if the remote specification source is compromised, although it is a standard pattern for API-integrated agents.
- Socketpass
No alerts
- Snykfail
Risk: HIGH · 2 issues
- Runlayerpass
1/1 file flagged
What does this agent skill do?
OpenAPI-First Rule
Before generating or executing API calls, fetch:
https://api.remix.gg/docs/json
Use OpenAPI as the contract source of truth for:
- methods (
GET/POST/...) - paths
- params/query/body schemas
- response shapes
Base headers:
Authorization: Bearer <api_key>
Content-Type: application/json
Base URL: https://api.remix.gg
OpenAPI UI: https://api.remix.gg/docs
Response Envelope
Success:
{ "success": true, "data": { "...": "..." } }
Error:
{ "success": false, "error": { "code": "SOME_CODE", "message": "...", "details": null } }
Endpoint Families
Use OpenAPI for exact paths; these are the stable groups:
- Metadata: categories
- Games: list/detail/create/update
- Analytics: overview, shop, and leaderboard analytics for owned games
- Versions: list/detail/code/thread/status/validate/code-update
- Assets: list game assets, upload assets via
POST /v1/games/{gameId}/assets - Images: generate images via
POST /v1/games/{gameId}/images/generate - Shop images: generate shop icon art via
POST /v1/games/{gameId}/images/generate-shop-icon - Sprites: generate sprites via
POST /v1/games/{gameId}/sprites/generate - Items: manage shop items via
GET/POST /v1/games/{gameId}/items,POST/DELETE /v1/games/{gameId}/items/{itemId} - Readiness: launch readiness checks
Not Exposed in Agent REST
- No delete route.
- No create-version route.
- No submit route.
Asset Upload
Asset uploads are available via POST /v1/games/{gameId}/assets. You can upload binary files (icons, sprites, audio) directly through the API.
Assets can also be managed through the Remix app/Studio upload flow.
Canonical flow:
- create game
- upload/update version code
- upload assets as needed via
POST /v1/games/{gameId}/assets - optionally inspect analytics via the overview/shop/leaderboard endpoints
- validate and/or launch-readiness
- check status
Common Error Codes
UNAUTHORIZED- Missing/invalid API key.ACCOUNT_INELIGIBLE- User is banned/deleted.FORBIDDEN- User does not own the game/version.GAME_NOT_FOUND- Game missing.VERSION_NOT_FOUND- Game/version mismatch or missing.MAX_IN_DEV_GAMES_EXCEEDED- Creator reached cap.VALIDATION_ERROR- Body/query failed validation.INVALID_JSON- Body could not be parsed as JSON.LIVE_VERSION_LOCKED- Attempted to edit a live version.VERSION_NOT_EDITABLE- Version is submitted/approved/launched.THREAD_CREATE_FAILED- Failed to provision upload thread.RATE_LIMITED- API key rate limit exceeded.INTERNAL_SERVER_ERROR- Unexpected server failure.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/farworld-labs/remix-skills/remix-api-reference">View remix-api-reference on skillZs</a>