Gametize Public API Documentation

Everything needed to build tools (including AI-assisted tools) that upload media and create Gametize Projects from JSON.

Available documentation

• project-tools.yaml - OpenAPI 3.0.3 specification: file upload + project import operations, fields, and error codes.
• project-json-guide.md - guide to building a valid project JSON (structure, supported challenge types, import rules).
• project-json-example.json - a complete, import-ready example project JSON.

Typical flow

1. Read the guide and the example to build a valid project JSON document.
2. Upload any images or media via POST /api/admin/v1/files/upload.json and use the returned fileUrl in the JSON.
3. Create the project via POST /api/admin/v1/projects/import.json (send the JSON as projectJson, or as a projectJsonFile upload for large payloads).

Authentication

Both operations require Admin API client credentials (an X-Admin-Client-Key and X-Admin-Client-Secret header pair) issued for your platform. Contact your Gametize account manager to obtain them. This documentation itself is public; the API endpoints it describes are not.