{"openapi":"3.1.0","info":{"title":"Game Toolbox API","version":"0.1.0"},"paths":{"/v1/tools":{"get":{"summary":"Tools","description":"List operations and input schemas available to this credential.","operationId":"discover_tools","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{},{"ToolboxBearer":[]}]}},"/v1/artifacts/{artifact_id}":{"get":{"summary":"Read Artifact","description":"Download an authorized artifact in its stored media type. Supports a single byte range.","operationId":"read_artifact_bytes","parameters":[{"name":"artifact_id","in":"path","required":true,"schema":{"type":"string","title":"Artifact Id"}},{"in":"header","name":"Range","schema":{"type":"string"}},{"in":"header","name":"If-Range","schema":{"type":"string"}}],"responses":{"200":{"description":"Complete file","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"206":{"description":"Partial file","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Artifact unavailable"},"416":{"description":"Range unavailable"},"429":{"description":"Download allowance exhausted"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{},{"ToolboxBearer":[]}]}},"/v1/connections":{"post":{"summary":"Endpoint","description":"Connect an operator-configured provider for this project.","operationId":"connect_provider","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"provider":{"type":"string"},"alias":{"type":"string"},"requested_scopes":{"type":"array","items":{"type":"string"}},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"required":["provider"]}}}}}},"/v1/artifacts":{"post":{"summary":"Endpoint","description":"Verify and persist a private artifact for the current project.","operationId":"upload_artifact","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"filename":{"type":"string"},"content_base64":{"type":"string"},"content_type":{"type":"string"},"sha256":{"type":"string"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"required":["filename","content_base64"]}}}}}},"/v1/jobs/{job_id}":{"get":{"summary":"Endpoint","description":"Retrieve the current status and result of a project job.","operationId":"read_job","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"job_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."}],"security":[{"ToolboxBearer":[]}]}},"/v1/usage":{"get":{"summary":"Endpoint","description":"Check catalog and public artifact download usage, allowances and reset times.","operationId":"read_usage","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."}],"security":[{},{"ToolboxBearer":[]}]}},"/v1/capabilities":{"get":{"summary":"Endpoint","description":"Discover portable and native workflows.","operationId":"list_capabilities","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."},{"in":"query","name":"engine","schema":{"type":"string"},"required":false},{"in":"query","name":"version","schema":{"type":"string"},"required":false},{"in":"query","name":"target","schema":{"type":"string"},"required":false},{"in":"query","name":"plugins","schema":{"type":["string","array"]},"required":false}],"security":[{},{"ToolboxBearer":[]}]}},"/v1/integration-recipes/{recipe_id}":{"get":{"summary":"Endpoint","description":"Read a pinned portable format recipe or engine-specific integration instructions.","operationId":"get_integration_recipe","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"recipe_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."},{"in":"query","name":"version","schema":{"type":"string"},"required":false},{"in":"query","name":"target","schema":{"type":"string"},"required":false},{"in":"query","name":"format","schema":{"type":"string"},"required":false}],"security":[{},{"ToolboxBearer":[]}]}},"/v1/import-recipes/resolve":{"post":{"summary":"Endpoint","description":"Resolve import steps from a file format or asset manifest. An optional engine profile adds editor instructions.","operationId":"get_import_recipe","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"format":{"type":"string"},"asset_manifest":{"type":"object"},"engine_profile":{"type":"object"},"desired_role":{"type":"string"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}}}}}}}},"/v1/modules":{"get":{"summary":"Endpoint","description":"Discover reusable camera follow modules.","operationId":"search_modules","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."},{"in":"query","name":"engine","schema":{"type":"string"},"required":false},{"in":"query","name":"version","schema":{"type":"string"},"required":false},{"in":"query","name":"target","schema":{"type":"string"},"required":false},{"in":"query","name":"engine_profile","schema":{"type":"object"},"required":false},{"in":"query","name":"role","schema":{"type":"string"},"required":false}],"security":[{},{"ToolboxBearer":[]}]}},"/v1/module-installations":{"post":{"summary":"Endpoint","description":"Plan a safe local installation by comparing existing file hashes.","operationId":"install_module","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"module_id":{"type":"string"},"version":{"type":"string"},"engine_profile":{"type":"object"},"project_facts":{"type":"object"},"local_hashes":{"type":"object"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"required":["module_id"]}}}}}},"/v1/assets":{"get":{"summary":"Endpoint","description":"Search the public game asset catalog by type (audio, texture, animation, sprite and more), pack ID, keywords, role, style, format or clip. All filters are optional.","operationId":"search_assets","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."},{"in":"query","name":"asset_type","schema":{"type":"string","enum":["audio","sound_effect","music","ambience","texture","material","model","animation","sprite","spritesheet","tile","tileset","ui","hdri","pack"],"description":"Filter by category. Audio covers sound effects, music and ambience. Animation includes models with embedded clips. Pack finds complete ZIPs."},"required":false},{"in":"query","name":"pack_id","schema":{"type":"string","description":"Limit results to a pack and its indexed member files.","examples":["rpg-audio","robot-expressive"]},"required":false},{"in":"query","name":"query","schema":{"type":"string","maxLength":512,"description":"Search titles, roles, tags and clips. A category alone also works, including plurals and common names such as sprites, textures or SFX."},"required":false},{"in":"query","name":"role","schema":{"type":"string","description":"Exact in-game role such as character, prop or floor."},"required":false},{"in":"query","name":"style","schema":{"type":"string","examples":["ember-dungeon"]},"required":false},{"in":"query","name":"format","schema":{"type":"string","description":"Source format such as png, glb, ogg, wav or zip."},"required":false},{"in":"query","name":"required_clip","schema":{"type":"string","description":"Require a named animation clip, such as Walk (case-insensitive)."},"required":false},{"in":"query","name":"similar_to","schema":{"type":"string","description":"ID of a catalog asset to find compatible alternatives for."},"required":false},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"required":false},{"in":"query","name":"cursor","schema":{"type":"string","description":"Use next_cursor with the same search to get the following page."},"required":false}],"security":[{},{"ToolboxBearer":[]}]}},"/v1/assets/{asset_id}":{"get":{"summary":"Endpoint","description":"Read a versioned asset manifest.","operationId":"get_asset","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"asset_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."},{"in":"query","name":"version","schema":{"type":"string"},"required":false}],"security":[{},{"ToolboxBearer":[]}]}},"/v1/packs/{pack_id}":{"get":{"summary":"Endpoint","description":"Read the pack version, license, member paths, sizes and SHA-256 hashes. Curated packs include a ZIP asset ID.","operationId":"get_asset_pack","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"pack_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."},{"in":"query","name":"version","schema":{"type":"string"},"required":false}],"security":[{},{"ToolboxBearer":[]}]}},"/v1/assets/{asset_id}/download":{"get":{"summary":"Endpoint","description":"Issue a download URL for one file or a whole pack ZIP. Each signed URL uses one download. Locally served Ember files count when their bytes are retrieved.","operationId":"download_asset","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"asset_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."},{"in":"query","name":"version","schema":{"type":"string"},"required":false},{"in":"query","name":"variant","schema":{"type":"string"},"required":false}],"security":[{},{"ToolboxBearer":[]}]}},"/v1/asset-validations":{"post":{"summary":"Endpoint","description":"Inspect source bytes and validate required roles. For external catalog files, upload the source and pass its artifact_ref.","operationId":"validate_asset","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"artifact_ref":{"type":["object","string"]},"asset_id":{"type":"string"},"version":{"type":"string"},"filename":{"type":"string"},"declared_metadata":{"type":"object"},"required_roles":{"type":"array"},"supplied_files":{"type":"array"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}}}}}}}},"/v1/maps":{"post":{"summary":"Endpoint","description":"Generate a seeded room grid. Set recipe.layout to branching for a fork and a key off the exit route (4–32 rooms).","operationId":"generate_map","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"recipe":{"type":"object"},"seed":{"type":"integer"},"movement_rules":{"type":"object"},"engine":{"type":"string"},"target":{"type":"string"},"generator_version":{"type":"string"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}}}}}}}},"/v1/map-validations":{"post":{"summary":"Endpoint","description":"Find a path obeying gate and clearance rules.","operationId":"validate_map","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"map_spec":{"type":"object"},"map_id":{"type":"string"},"movement_rules":{"type":"object"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}}}}}}}},"/v1/map-exports":{"post":{"summary":"Endpoint","description":"Export a map as portable JSON or a Tiled layout.","operationId":"export_map","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"map_spec":{"type":"object"},"map_id":{"type":"string"},"format":{"type":"string"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}}}}}}}},"/v1/map-variant-jobs":{"post":{"summary":"Endpoint","description":"Generate a bounded batch with the same linear or branching recipe as generate_map.","operationId":"generate_map_variants","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"recipe":{"type":"object"},"start_seed":{"type":"integer"},"count":{"type":"integer"},"seeds":{"type":"array"},"movement_rules":{"type":"object"},"work_limit":{"type":"integer"},"generator_version":{"type":"string"},"seeds_per_call":{"type":"integer"},"resume_job_id":{"type":"string"},"cancel":{"type":"boolean"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}}}}}}}},"/v1/map-validation-jobs":{"post":{"summary":"Endpoint","description":"Check a seed corpus and return exact failing replays.","operationId":"test_map_seeds","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"recipe":{"type":"object"},"start_seed":{"type":"integer"},"count":{"type":"integer"},"seeds":{"type":"array"},"movement_rules":{"type":"object"},"work_limit":{"type":"integer"},"generator_version":{"type":"string"},"seeds_per_call":{"type":"integer"},"resume_job_id":{"type":"string"},"cancel":{"type":"boolean"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}}}}}}}},"/v1/pack-locks":{"post":{"summary":"Endpoint","description":"Resolve exact compatible pack versions across a dependency graph.","operationId":"resolve_dependencies","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"root_manifest":{"type":"object"},"available":{"type":"array"},"existing_lock":{"type":"object"},"pack_id":{"type":"string"},"version":{"type":"string"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}}}}}}}},"/v1/pack-diffs":{"post":{"summary":"Endpoint","description":"Compare pack locks, detect renames, and protect local edits.","operationId":"diff_pack","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"old_lock":{"type":"object"},"new_lock":{"type":"object"},"local_hashes":{"type":"object"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"required":["old_lock","new_lock"]}}}}}},"/v1/pack-credits":{"post":{"summary":"Endpoint","description":"Render a game-ready asset credits file.","operationId":"export_credits","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lock":{"type":"object"},"format":{"type":"string"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"required":["lock"]}}}}}},"/v1/engine-variants":{"post":{"summary":"Endpoint","description":"Choose a conversion from the source file. An optional engine profile adds editor-specific import guidance.","operationId":"prepare_for_engine","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"artifact_ref":{"type":["object","string"]},"engine_profile":{"type":"object"},"filename":{"type":"string"},"requested_role":{"type":"string"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"required":["artifact_ref"]}}}}}},"/v1/conversions":{"post":{"summary":"Endpoint","description":"Pack sprites, resample PCM loops, or transform a static GLB.","operationId":"convert_asset","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"artifact_ref":{"type":["object","string"]},"artifact_refs":{"type":"array"},"profile":{"type":"string"},"profile_revision":{"type":"string"},"transforms":{"type":"object"},"provenance":{"type":"object"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}}}}}}}},"/v1/generated-assets":{"post":{"summary":"Endpoint","description":"Generate local pixel art or sound variants with measured output.","operationId":"generate_asset","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"modality":{"type":"string"},"role":{"type":"string"},"role_brief":{"type":"string"},"brief":{"type":"string"},"provider":{"type":"string"},"requirements":{"type":"object"},"references":{"type":"array"},"max_spend":{"type":"number"},"idempotency_key":{"type":"string"}},"required":["modality"]}}}}}},"/v1/generated-assets/{job_id}/variants":{"get":{"summary":"Endpoint","description":"Read generated files, quality measurements and usage terms.","operationId":"get_variants","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"job_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."}],"security":[{"ToolboxBearer":[]}]}},"/v1/quests":{"post":{"summary":"Endpoint","description":"Create an editable original quest graph or fact-based lore.","operationId":"generate_quest","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"recipe":{"type":"object"},"world_rules":{"type":"object"},"entities":{"type":"array"},"locale":{"type":"string"},"output_kind":{"type":"string"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}}}}}}}},"/v1/dialogue-validations":{"post":{"summary":"Endpoint","description":"Traverse branches and state changes and explain unreachable nodes.","operationId":"validate_dialogue","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"graph":{"type":"object"},"initial_state":{"type":"object"},"declared_facts":{"type":"array"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"required":["graph"]}}}}}},"/v1/locale-checks":{"post":{"summary":"Endpoint","description":"Find missing or stale translations, placeholder drift and stale voice references.","operationId":"check_locales","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"line_manifest":{"type":"object"},"translations":{"type":"object"},"glossary":{"type":"object"},"voice_refs":{"type":"object"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"required":["line_manifest","translations"]}}}}}},"/v1/rooms":{"post":{"summary":"Endpoint","description":"Provision a bounded Nakama playtest or invitation room from a trusted backend and return join metadata. For shipped matchmaking, use export_matchmaking_kit.","operationId":"provision_room","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connection_id":{"type":"string"},"capacity":{"type":"integer"},"ttl_seconds":{"type":"integer"},"player_ids":{"type":"array"},"idempotency_key":{"type":"string"},"region":{"type":"string"}},"additionalProperties":true,"required":["connection_id"]}}}}}},"/v1/rooms/{room_id}":{"get":{"summary":"Endpoint","description":"Read current Nakama room state, occupancy, and expiry.","operationId":"get_room","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"room_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."}],"security":[{"ToolboxBearer":[]}]},"delete":{"summary":"Endpoint","description":"Close a room and revoke its join metadata.","operationId":"close_room","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"room_id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."},{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."}],"security":[{"ToolboxBearer":[]}]}},"/v1/server-quotes":{"post":{"summary":"Endpoint","description":"Verify a registered Edgegap trial build and lock one zero-charge allocation offer.","operationId":"quote_server","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"connection_id":{"type":"string"},"build_ref":{"type":"string"},"region":{"type":"string"},"duration_seconds":{"type":"integer"},"resources":{"type":"object"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["connection_id","build_ref"]}}}}}},"/v1/servers":{"post":{"summary":"Endpoint","description":"Consume a trial quote once to allocate the prebuilt server.","operationId":"provision_server","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"quote_id":{"type":"string"},"spending_limit_minor":{"type":"integer"},"idempotency_key":{"type":"string"}},"additionalProperties":true,"required":["quote_id","spending_limit_minor"]}}}}}},"/v1/servers/{server_id}":{"get":{"summary":"Endpoint","description":"Refresh provider status. Join verification requires a local client receipt for the current endpoint.","operationId":"get_server","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"server_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."}],"security":[{"ToolboxBearer":[]}]},"delete":{"summary":"Endpoint","description":"Request teardown and expose its reconciliation status.","operationId":"stop_server","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"server_id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."},{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."}],"security":[{"ToolboxBearer":[]}]}},"/v1/servers/{server_id}/join-receipts":{"post":{"summary":"Endpoint","description":"Record the outcome from a local game client joining the current server endpoint.","operationId":"record_server_join","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"server_id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"object"},"joined":{"type":"boolean"},"build_id":{"type":"string"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["endpoint","joined"]}}}}}},"/v1/multiplayer-scenarios/{scenario_id}":{"get":{"summary":"Endpoint","description":"Retrieve checkpoints for a local two-client multiplayer scenario.","operationId":"get_multiplayer_scenario","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"scenario_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."},{"in":"query","name":"engine_profile","schema":{"type":"object"},"required":false}],"security":[{"ToolboxBearer":[]}]}},"/v1/multiplayer-test-results":{"post":{"summary":"Endpoint","description":"Compare correlated checkpoint evidence for two clients and persist a verdict.","operationId":"record_test_results","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"run_id":{"type":"string"},"timelines":{"type":"object"},"scenario_revision":{"type":"integer"},"bindings":{"type":"object"},"expected_values":{"type":"object"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["run_id","timelines"]}}}}}},"/v1/lobbies/config":{"put":{"summary":"Endpoint","description":"Define lobby capacity and access policy for the project.","operationId":"configure_lobbies","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"capacity":{"type":"integer"},"connection_id":{"type":"string"},"join_policy":{"type":"string"},"expected_revision":{"type":"integer"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true}}}}}},"/v1/matchmaking/rules/{rule_id}":{"put":{"summary":"Endpoint","description":"Version party size, skill, region, and timeout rules.","operationId":"define_match_rules","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"rule_id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"target_players":{"type":"integer"},"timeout_seconds":{"type":"integer"},"skill_gap":{"type":"integer"},"region_locked":{"type":"boolean"},"relaxation":{"type":"array"},"expected_revision":{"type":"integer"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true}}}}}},"/v1/matchmaking/tests":{"post":{"summary":"Endpoint","description":"Simulate queue arrivals, cancellations, and bounded skill relaxation.","operationId":"test_matchmaking","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rule_id":{"type":"string"},"arrivals":{"type":"array"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["rule_id","arrivals"]}}}}}},"/v1/matchmaking/rules/{rule_id}/requests":{"post":{"summary":"Endpoint","description":"Preview a Nakama queue ticket during development. Use export_matchmaking_kit to ship independent matchmaking.","operationId":"prepare_matchmaker_request","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"rule_id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"region":{"type":"string"},"skill":{"type":"integer"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["region"]}}}}}},"/v1/matchmaking/rules/{rule_id}/export":{"post":{"summary":"Endpoint","description":"Export a client rule, offline ticket builders and authoritative server modules. Supply your game's public Nakama origin as client_endpoint.","operationId":"export_matchmaking_kit","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"rule_id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"client_endpoint":{"type":"string"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["client_endpoint"]}}}}}},"/v1/leaderboards/{board_id}":{"put":{"summary":"Endpoint","description":"Version a maximum-score seasonal board and its ordering.","operationId":"define_leaderboard","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"board_id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"scoring_mode":{"type":"string"},"ordering":{"type":"string"},"season_seconds":{"type":"integer"},"season_start":{"type":"integer"},"expected_revision":{"type":"integer"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true}}}}}},"/v1/achievements/{achievement_id}":{"put":{"summary":"Endpoint","description":"Define an event threshold and a grant policy.","operationId":"define_achievement","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"achievement_id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"condition":{"type":"object"},"per_season":{"type":"boolean"},"expected_revision":{"type":"integer"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["condition"]}}}}}},"/v1/progression/tests":{"post":{"summary":"Endpoint","description":"Simulate score events and achievement grants against a fixed clock.","operationId":"test_progression","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"board_id":{"type":"string"},"events":{"type":"array"},"now":{"type":"integer"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["board_id","events"]}}}}}},"/v1/progression/events":{"post":{"summary":"Endpoint","description":"Submit a trusted game-backend score event idempotently.","operationId":"submit_progression_event","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"board_id":{"type":"string"},"event_id":{"type":"string"},"player_id":{"type":"string"},"score":{"type":"number"},"at":{"type":"integer"},"event":{"type":"string"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["board_id","event_id","player_id","score"]}}}}}},"/v1/progression/boards/{board_id}":{"get":{"summary":"Endpoint","description":"Read ranks and grants for the current or a specified board revision.","operationId":"get_progression","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"board_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."},{"in":"query","name":"board_revision","schema":{"type":"integer"},"required":false}],"security":[{"ToolboxBearer":[]}]}},"/v1/player-auth/config":{"put":{"summary":"Endpoint","description":"Configure first-party guests or generate Nakama identity integration steps.","operationId":"configure_player_auth","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"connection_id":{"type":"string"},"guest_access":{"type":"boolean"},"expected_revision":{"type":"integer"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true}}}}}},"/v1/saves/config":{"put":{"summary":"Endpoint","description":"Version save schema, migration, and conflict recovery policy.","operationId":"configure_saves","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"type":"integer"},"migration":{"type":"object"},"conflict_policy":{"type":"string"},"expected_revision":{"type":"integer"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true}}}}}},"/v1/player-rules/exports":{"post":{"summary":"Endpoint","description":"Download selected save migrations, leaderboard, achievement and reward definitions for use in your game or backend.","operationId":"export_player_rules","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"include_saves":{"type":"boolean"},"board_ids":{"type":"array"},"achievement_ids":{"type":"array"},"catalog_ids":{"type":"array"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true}}}}}},"/v1/saves/restore-tests":{"post":{"summary":"Endpoint","description":"Exercise a recoverable linked-account restore with supplied test revisions.","operationId":"test_save_restore","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"test_principal":{"type":"string"},"saved_revisions":{"type":"array"},"choose_index":{"type":"integer"},"verified_account":{"type":"string"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["test_principal","saved_revisions"]}}}}}},"/v1/player-auth/guests":{"post":{"summary":"Endpoint","description":"Issue a first-party guest identity and short-lived player token for a trusted backend.","operationId":"create_guest_player","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true}}}}}},"/v1/player-auth/links":{"post":{"summary":"Endpoint","description":"Link a guest after a trusted game backend verified the external identity.","operationId":"link_player_account","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"player_token":{"type":"string"},"verified_account":{"type":"string"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["player_token","verified_account"]}}}}}},"/v1/player-auth/sessions":{"post":{"summary":"Endpoint","description":"Issue a player token after a trusted game backend verified a linked account.","operationId":"open_player_session","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"verified_account":{"type":"string"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["verified_account"]}}}}}},"/v1/player-saves/{slot}":{"put":{"summary":"Endpoint","description":"Save a revision or retain a conflicting edit under the same player and slot.","operationId":"write_player_save","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"slot","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"player_token":{"type":"string"},"expected_revision":{"type":"integer"},"payload":{"type":"object"},"schema_version":{"type":"integer"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["player_token","expected_revision","payload"]}}}}}},"/v1/player-saves/{slot}/reads":{"post":{"summary":"Endpoint","description":"Read a player-owned save or its revision history by revision number.","operationId":"read_player_save","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"slot","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"player_token":{"type":"string"},"revision":{"type":"integer"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["player_token"]}}}}}},"/v1/player-saves/{slot}/resolutions":{"post":{"summary":"Endpoint","description":"Restore or merge a retained conflict subject to the current revision.","operationId":"resolve_player_save","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"slot","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"player_token":{"type":"string"},"expected_revision":{"type":"integer"},"conflict_id":{"type":"string"},"payload":{"type":"object"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["player_token","expected_revision","conflict_id"]}}}}}},"/v1/economy/catalogs/{catalog_id}":{"put":{"summary":"Endpoint","description":"Define the versioned sandbox catalog and reward deltas.","operationId":"define_catalog","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"catalog_id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"revision":{"type":"integer"},"expected_revision":{"type":"integer"},"items":{"type":"array"},"currencies":{"type":"array"},"rewards":{"type":"object"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true}}}}}},"/v1/economy/reward-simulations":{"post":{"summary":"Endpoint","description":"Calculate the balances from a reward without persisting them.","operationId":"simulate_reward","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"catalog_id":{"type":"string"},"reward":{"type":"string"},"catalog_revision":{"type":"integer"},"initial_inventory":{"type":"object"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["catalog_id","reward"]}}}}}},"/v1/economy/inventory-tests":{"post":{"summary":"Endpoint","description":"Apply retry-safe sandbox grants locally or in an authorized PlayFab test account.","operationId":"test_inventory","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"catalog_id":{"type":"string"},"test_player":{"type":"string"},"requests":{"type":"array"},"catalog_revision":{"type":"integer"},"connection_id":{"type":"string"},"initial_inventory":{"type":"object"},"expected_inventory_revision":{"type":"integer"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["catalog_id","test_player","requests"]}}}}}},"/v1/projects/{project_id}/event-schema":{"put":{"summary":"Endpoint","description":"Define an immutable gameplay event schema and get runtime instrumentation examples.","operationId":"define_events","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"project_id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"integer"},"events":{"type":"array","items":{"type":"object"}},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["version","events"]}}}}}},"/v1/events":{"post":{"summary":"Endpoint","description":"Ingest a batch of uniquely identified events and receive timestamped receipts.","operationId":"record_events","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"events":{"type":"array","items":{"type":"object"}},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["events"]}}}}}},"/v1/playtest-evidence/imports":{"post":{"summary":"Endpoint","description":"Import a local UTF-8 JSON Lines playtest capture of gameplay events and issues after a session.","operationId":"import_playtest_evidence","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"capture_ref":{"anyOf":[{"type":"string"},{"type":"object"}]},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["capture_ref"]}}}}}},"/v1/event-verifications":{"post":{"summary":"Endpoint","description":"Check whether named events or IDs arrived for an exact build and session.","operationId":"verify_events","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"build_id":{"type":"string"},"session_id":{"type":"string"},"names":{"type":"array","items":{"type":"string"}},"event_names":{"type":"array","items":{"type":"string"}},"event_ids":{"type":"array","items":{"type":"string"}},"actor":{"type":["string","null"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["build_id","session_id"]}}}}}},"/v1/playtest-reports/{session_id}":{"get":{"summary":"Endpoint","description":"Count event names, human or automated participation, and errors for a build and session.","operationId":"get_playtest_report","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"session_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."},{"in":"query","name":"build_id","schema":{"type":"string"},"required":false},{"in":"query","name":"actor","schema":{"type":["string","null"]},"required":false}],"security":[{"ToolboxBearer":[]}]}},"/v1/web-previews":{"post":{"summary":"Endpoint","description":"Publish a bounded HTML5 ZIP to an isolated origin with a revocable browser grant.","operationId":"publish_web_preview","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"bundle_ref":{"anyOf":[{"type":"string"},{"type":"object"}]},"entry_point":{"type":"string"},"headers_profile":{"type":"string"},"ttl":{"type":"integer"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["bundle_ref"]}}}}}},"/v1/web-previews/{preview_id}":{"get":{"summary":"Endpoint","description":"Read preview status, expiry, immutable artifact hash, and browser evidence.","operationId":"get_preview","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"preview_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."}],"security":[{"ToolboxBearer":[]}]},"delete":{"summary":"Endpoint","description":"Revoke a browser grant for the HTML entry point and all bundled resources.","operationId":"expire_preview","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"preview_id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."},{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."}],"security":[{"ToolboxBearer":[]}]}},"/v1/web-previews/{preview_id}/checks":{"post":{"summary":"Endpoint","description":"Attach client-reported browser checkpoint evidence to an exact preview export hash.","operationId":"record_preview_check","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"preview_id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"artifact_sha256":{"type":"string"},"checkpoint":{"type":"string"},"browser":{"type":"string"},"passed":{"type":"boolean"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["artifact_sha256","checkpoint","browser","passed"]}}}}}},"/v1/analytics/funnels":{"post":{"summary":"Endpoint","description":"Compute an ordered funnel from direct gameplay data, a bounded export, or a connected PostHog project.","operationId":"query_funnel","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"steps":{"type":"array","items":{"type":"string"}},"window":{"type":"object"},"build_id":{"type":"string"},"actor":{"type":["string","null"]},"events":{"type":"array","items":{"type":"object"}},"events_ref":{"anyOf":[{"type":"string"},{"type":"object"}]},"connection_id":{"type":"string"},"exclude_session_ids":{"type":"array","items":{"type":"string"}},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["steps"]}}}}}},"/v1/analytics/build-comparisons":{"post":{"summary":"Endpoint","description":"Compare completion rates or named event counts for two builds with common event filters.","operationId":"compare_builds","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"build_ids":{"type":"array","items":{"type":"string"}},"metric":{"type":"string"},"event_name":{"type":"string"},"steps":{"type":"array","items":{"type":"string"}},"window":{"type":"object"},"actor":{"type":["string","null"]},"events":{"type":"array","items":{"type":"object"}},"events_ref":{"anyOf":[{"type":"string"},{"type":"object"}]},"connection_id":{"type":"string"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["build_ids"]}}}}}},"/v1/issues/events":{"post":{"summary":"Endpoint","description":"Record a scoped crash envelope or tester note with an optional build fingerprint.","operationId":"record_issue","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_id":{"type":"string"},"build_id":{"type":"string"},"session_id":{"type":"string"},"kind":{"type":"string"},"build_fingerprint":{"type":"string"},"frames":{"type":"array","items":{"type":"string"}},"note":{"type":"string"},"input_log":{"type":"array"},"logs_ref":{"anyOf":[{"type":"string"},{"type":"object"}]},"map_seed":{"type":["integer","string","null"]},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["event_id","build_id","session_id"]}}}}}},"/v1/issues/debug-symbols/{build_id}":{"put":{"summary":"Endpoint","description":"Register a JSON frame-label map linked to an exact build and optional fingerprint.","operationId":"register_debug_symbols","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"build_id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol_ref":{"anyOf":[{"type":"string"},{"type":"object"}]},"build_fingerprint":{"type":"string"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["symbol_ref"]}}}}}},"/v1/issues":{"get":{"summary":"Endpoint","description":"Group direct issue envelopes by build and signature or read a configured hosted issue page.","operationId":"list_issues","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."},{"in":"query","name":"build_id","schema":{"type":"string"},"required":false},{"in":"query","name":"build_fingerprint","schema":{"type":"string"},"required":false},{"in":"query","name":"query","schema":{"type":"string"},"required":false},{"in":"query","name":"limit","schema":{"type":"integer"},"required":false},{"in":"query","name":"cursor","schema":{"type":"string"},"required":false},{"in":"query","name":"connection_id","schema":{"type":"string"},"required":false},{"in":"query","name":"provider","schema":{"type":"string"},"required":false}],"security":[{"ToolboxBearer":[]}]}},"/v1/sessions/{session_id}/evidence":{"get":{"summary":"Endpoint","description":"Retrieve build-scoped session evidence with symbol and reproduction status.","operationId":"get_session_evidence","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"session_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."},{"in":"query","name":"build_id","schema":{"type":"string"},"required":false},{"in":"query","name":"build_fingerprint","schema":{"type":"string"},"required":false}],"security":[{"ToolboxBearer":[]}]}},"/v1/issues/{event_id}/reproduction":{"post":{"summary":"Endpoint","description":"Record a client-reported reproduction and tie it to the observed crash build fingerprint.","operationId":"record_issue_reproduction","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"event_id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"checkpoint":{"type":"string"},"reproduced":{"type":"boolean"},"build_fingerprint":{"type":"string"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["checkpoint","reproduced"]}}}}}},"/v1/releases":{"post":{"summary":"Endpoint","description":"Stage and hash an already-built artifact for a private release channel.","operationId":"stage_release","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"build_ref":{"anyOf":[{"type":"string"},{"type":"object"}]},"channel":{"type":"string"},"target":{"type":"string"},"metadata":{"type":"object"},"connection_id":{"type":"string"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["build_ref","channel"]}}}}}},"/v1/channels/{channel_id}/promotions":{"post":{"summary":"Endpoint","description":"Use compare-and-set to set an internal channel to an exact staged artifact.","operationId":"promote_release","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"channel_id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"release_id":{"type":"string"},"expected_revision":{"type":"integer"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["release_id","expected_revision"]}}}}}},"/v1/channels/{channel_id}/rollbacks":{"post":{"summary":"Endpoint","description":"Restore an earlier promoted artifact using the current channel revision.","operationId":"rollback_release","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"channel_id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"release_id":{"type":"string"},"expected_revision":{"type":"integer"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["release_id","expected_revision"]}}}}}},"/v1/channels/{channel_id}":{"get":{"summary":"Endpoint","description":"Read the active download reference and immutable hash for a private build channel.","operationId":"get_release_channel","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"channel_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."}],"security":[{"ToolboxBearer":[]}]}},"/v1/release-promotions/{promotion_id}":{"get":{"summary":"Endpoint","description":"Retrieve the staged build and approved itch.io publishing destination.","operationId":"get_release_promotion","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"promotion_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."}],"security":[{"ToolboxBearer":[]}]}},"/v1/release-promotions/{promotion_id}/upload":{"post":{"summary":"Endpoint","description":"Claim a single butler upload for the approved external release promotion.","operationId":"begin_release_upload","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"promotion_id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true}}}}}},"/v1/release-promotions/{promotion_id}/delivery":{"put":{"summary":"Endpoint","description":"Record owner-run butler processing or verify bytes from a publisher-supplied external download.","operationId":"record_release_delivery","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"promotion_id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"state":{"type":"string"},"provider_receipt":{"type":"string"},"observed_artifact_ref":{"anyOf":[{"type":"string"},{"type":"object"}]},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["state","provider_receipt"]}}}}}},"/v1/config/diffs":{"post":{"summary":"Endpoint","description":"Compare typed old and new game configuration and detect incompatible changes.","operationId":"diff_config","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"new_config":{"type":"object"},"old_config":{"type":"object"},"schema":{"type":"object"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["new_config"]}}}}}},"/v1/config/rollouts":{"post":{"summary":"Endpoint","description":"Atomically activate a weighted revision or restore an earlier rollout.","operationId":"roll_out_config","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"environment":{"type":"string"},"expected_revision":{"type":"integer"},"config":{"type":"object"},"schema":{"type":"object"},"variants":{"type":"object"},"restore_revision":{"type":"integer"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["environment","expected_revision"]}}}}}},"/v1/config/environments/{environment}/exports":{"post":{"summary":"Endpoint","description":"Export bundled public game settings, weighted variants and a standalone reference resolver for offline assignments.","operationId":"export_config_snapshot","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"environment","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true}}}}}},"/v1/config/environments/{environment}/assignment":{"get":{"summary":"Endpoint","description":"Read an assignment from the hosted configuration service when the game opts into live evaluation.","operationId":"get_runtime_config","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"environment","required":true,"schema":{"type":"string"}},{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."},{"in":"query","name":"assignment_id","schema":{"type":"string"},"required":false}],"security":[{"ToolboxBearer":[]}]}},"/v1/config/exposures":{"post":{"summary":"Endpoint","description":"Record the first time a variant was applied, accepting a buffered exposure's original timestamp.","operationId":"record_config_exposure","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rollout_id":{"type":"string"},"assignment_id":{"type":"string"},"variant":{"type":"string"},"timestamp":{"type":"string"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["rollout_id","assignment_id","variant"]}}}}}},"/v1/experiments/comparisons":{"post":{"summary":"Endpoint","description":"Compare binary outcomes by unique exposed player and report uncertainty.","operationId":"compare_variants","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"primary_metric":{"type":"string"},"exposures":{"type":"array","items":{"type":"object"}},"outcomes":{"type":"array","items":{"type":"object"}},"rollout_id":{"type":"string"},"window":{"type":"object"},"control_variant":{"type":"string"},"candidate_variant":{"type":"string"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["primary_metric"]}}}}}},"/v1/device-test-quotes":{"post":{"summary":"Endpoint","description":"Quote capped billable lab minutes for configured devices, repeats, and one package fingerprint.","operationId":"quote_device_test","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lab_id":{"type":"string"},"build_fingerprint":{"type":"string"},"scenario":{"type":"string"},"devices":{"type":"array","items":{"type":"string"}},"repeats":{"type":"integer"},"per_device_timeout":{"type":"integer"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["lab_id","build_fingerprint","scenario","devices"]}}}}}},"/v1/device-tests":{"post":{"summary":"Endpoint","description":"Reserve a device run within the accepted USD cent limit for an authorized runner.","operationId":"run_device_test","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"quote_id":{"type":"string"},"package_ref":{"anyOf":[{"type":"string"},{"type":"object"}]},"max_spend_us_cents":{"type":"integer"},"idempotency_key":{"type":"string"}},"additionalProperties":true,"required":["quote_id","package_ref","max_spend_us_cents"]}}},"description":"Supply an idempotency key in the body or the Idempotency-Key header."}}},"/v1/device-tests/{run_id}/claim":{"post":{"summary":"Endpoint","description":"Claim a single queued lab reservation for an operator-controlled runner.","operationId":"claim_device_test","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"run_id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true}}}}}},"/v1/device-tests/{run_id}/dispatch":{"get":{"summary":"Endpoint","description":"Read whether a claimed lab run has a cancellation request or linked provider reference.","operationId":"get_device_run_dispatch","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"run_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."}],"security":[{"ToolboxBearer":[]}]}},"/v1/device-tests/{run_id}/result":{"put":{"summary":"Endpoint","description":"Record a lab runner's real provider state, outcomes and billable cents using the claim token.","operationId":"record_device_result","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"run_id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"claim_token":{"type":"string"},"state":{"type":"string"},"provider_ref":{"type":"string"},"actual_us_cents":{"type":"integer"},"outcomes":{"type":"array","items":{"type":"object"}},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["claim_token","state"]}}}}}},"/v1/device-tests/{run_id}/report":{"get":{"summary":"Endpoint","description":"Read held or settled lab usage and reported device outcomes.","operationId":"get_device_report","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"run_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."}],"security":[{"ToolboxBearer":[]}]}},"/v1/device-performance-comparisons":{"post":{"summary":"Endpoint","description":"Compare repeated measurements collected under matching device conditions.","operationId":"compare_performance","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"baseline_runs":{"type":"array","items":{"type":"object"}},"candidate_runs":{"type":"array","items":{"type":"object"}},"metric":{"type":"string"},"preference":{"type":"string"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["baseline_runs","candidate_runs"]}}}}}},"/v1/device-tests/{run_id}":{"delete":{"summary":"Endpoint","description":"Cancel a queued run or signal a cancellation to its assigned runner.","operationId":"cancel_device_test","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"run_id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."},{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."}],"security":[{"ToolboxBearer":[]}]}},"/v1/content-diffs":{"post":{"summary":"Endpoint","description":"Compare two inline manifests by verified checksum and estimate the missing transfer.","operationId":"diff_content","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"old_manifest":{"type":"object"},"new_manifest":{"type":"object"},"client_schema":{"type":"integer"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["old_manifest","new_manifest"]}}}}}},"/v1/content-channels/{channel_id}/releases":{"post":{"summary":"Endpoint","description":"Validate referenced bytes, then publish a versioned content manifest atomically.","operationId":"publish_content","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"channel_id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"manifest":{"type":"object"},"expected_revision":{"type":"integer"},"artifact_refs":{"type":"object"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["manifest","expected_revision"]}}}}}},"/v1/content-channels/{channel_id}/reverts":{"post":{"summary":"Endpoint","description":"Restore a prior immutable content release without modifying the game executable.","operationId":"revert_content","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"channel_id","required":true,"schema":{"type":"string"}},{"in":"header","name":"Idempotency-Key","schema":{"type":"string","minLength":1,"maxLength":160},"description":"Equivalent to idempotency_key in the operation input. Reuse on retry."}],"security":[{"ToolboxBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"release_id":{"type":"string"},"expected_revision":{"type":"integer"},"idempotency_key":{"type":"string","minLength":1,"maxLength":160,"description":"Reuse the same key when retrying the same request."}},"additionalProperties":true,"required":["release_id","expected_revision"]}}}}}},"/v1/content-channels/{channel_id}/export":{"get":{"summary":"Endpoint","description":"Export a compatible static channel.json and a source artifact per unique blob for bundling or game-owned CDN delivery.","operationId":"export_content_channel","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"channel_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."},{"in":"query","name":"client_schema","schema":{"type":"integer"},"required":false}],"security":[{"ToolboxBearer":[]}]}},"/v1/content-channels/{channel_id}":{"get":{"summary":"Endpoint","description":"Get a compatible release for games that opt into hosted content delivery.","operationId":"get_content_channel","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"parameters":[{"in":"path","name":"channel_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"input","schema":{"type":"string"},"description":"JSON object with operation arguments."},{"in":"query","name":"client_schema","schema":{"type":"integer"},"required":false}],"security":[{"ToolboxBearer":[]}]}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"ToolboxBearer":{"type":"http","scheme":"bearer"}}}}