# Forge

## Docs

- [Create Attribute](https://docs.forgegames.org/api-reference/attributes/create-attribute.md): Creates a new attribute for the specified team with name and optional min/max values.
- [Delete Attribute](https://docs.forgegames.org/api-reference/attributes/delete-attribute.md): Deletes an attribute from the team. Note: Will fail if attribute is attached to items.
- [List Attributes](https://docs.forgegames.org/api-reference/attributes/list-attributes.md): Lists all attributes associated with the specified team. Attributes define properties that can be assigned to items or instances within the team context.
- [Update Attribute](https://docs.forgegames.org/api-reference/attributes/update-attribute.md): Updates an existing attribute's properties including name, min, and max values.
- [Create Classifier](https://docs.forgegames.org/api-reference/classifiers/create-classifier.md): Creates a new classifier with associated options for a team
- [Delete Classifier](https://docs.forgegames.org/api-reference/classifiers/delete-classifier.md): Deletes a classifier and its associated options
- [List Classifiers](https://docs.forgegames.org/api-reference/classifiers/list-classifiers.md): Lists the classifiers defined for a specific team. Classifiers group items and manage item-related properties.
- [Update Classifier](https://docs.forgegames.org/api-reference/classifiers/update-classifier.md): Updates an existing classifier's properties
- [List Item Instance Spaces](https://docs.forgegames.org/api-reference/item-instance-spaces/list-item-instance-spaces.md): Lists all spaces where item instances are currently stored within a team. Item instance spaces map items to specific user-defined locations.
- [Create an Item Instance](https://docs.forgegames.org/api-reference/item-instances/create-an-item-instance.md): Creates an instance of an item within the specified team. Instances are generated from item templates and can have custom attributes and configurations.
- [Delete an Item Instance](https://docs.forgegames.org/api-reference/item-instances/delete-an-item-instance.md)
- [List Item Instances](https://docs.forgegames.org/api-reference/item-instances/list-item-instances.md): Lists all item instances within the specified team. Item instances represent individual occurrences of items with specific attributes and configurations.
- [Move an Item Instance](https://docs.forgegames.org/api-reference/item-instances/move-an-item-instance.md): Moves a specified item instance to a new location within the user's space grid.
- [Create Item](https://docs.forgegames.org/api-reference/items/create-item.md): Creates a new item blueprint with specified attributes and classifiers.
- [Delete Item](https://docs.forgegames.org/api-reference/items/delete-item.md): Deletes an item and its associated attributes and classifiers.
- [List Items](https://docs.forgegames.org/api-reference/items/list-items.md): Lists all items associated with the specified team. Items are blueprints that can be rolled, modified, or assigned attributes.
- [Roll an item](https://docs.forgegames.org/api-reference/items/roll-an-item.md): Generates a randomized variation of an item. This endpoint is commonly used for loot drops or creating unique instances in games.
- [Update Item](https://docs.forgegames.org/api-reference/items/update-item.md): Updates an existing item's properties, attributes, and classifiers.
- [Get Aggregated Roll Statistics](https://docs.forgegames.org/api-reference/roll-events/get-aggregated-roll-statistics.md): Returns team-level roll statistics including total rolls, unique items, and time-series data. Privacy-first: no individual roll exposure.
- [Get Item Drop Rates](https://docs.forgegames.org/api-reference/roll-events/get-item-drop-rates.md): Returns actual drop rates for items based on roll history. Useful for comparing expected vs actual drop rates.
- [Track Roll Event](https://docs.forgegames.org/api-reference/roll-events/track-roll-event.md): Records a roll event for telemetry. Stores team-level data only, no user-identifying information.
- [Create Space](https://docs.forgegames.org/api-reference/spaces/create-space.md): Creates a new space for the specified team.
- [Delete Space](https://docs.forgegames.org/api-reference/spaces/delete-space.md): Deletes a space from the team.
- [List Spaces](https://docs.forgegames.org/api-reference/spaces/list-spaces.md): Lists the spaces defined within a specific team. Spaces represent areas or containers where item instances can be stored.
- [Update Space](https://docs.forgegames.org/api-reference/spaces/update-space.md): Updates an existing space's properties.
- [Create Template](https://docs.forgegames.org/api-reference/templates/create-template.md): Creates a new template with specified type and configuration for gacha, roguelike, idle, or card pack systems.
- [Delete Template](https://docs.forgegames.org/api-reference/templates/delete-template.md): Deletes a template by ID.
- [Get Template by ID](https://docs.forgegames.org/api-reference/templates/get-template-by-id.md): Retrieves a single template by its unique identifier.
- [Get Templates by Type](https://docs.forgegames.org/api-reference/templates/get-templates-by-type.md): Retrieves all templates of a specific type (gacha, roguelike, idle, card_pack).
- [List Templates](https://docs.forgegames.org/api-reference/templates/list-templates.md): Lists all templates associated with the specified team. Templates define game system configurations like gacha, roguelike, idle, or card pack mechanics.
- [Update Template](https://docs.forgegames.org/api-reference/templates/update-template.md): Updates an existing template's name, type, or configuration.
- [Create a user space](https://docs.forgegames.org/api-reference/user-spaces/create-a-user-space.md): Creating a user space, allows the user to receive and store item instances.
- [Delete a user space](https://docs.forgegames.org/api-reference/user-spaces/delete-a-user-space.md)
- [List user spaces](https://docs.forgegames.org/api-reference/user-spaces/list-user-spaces.md)
- [Create a user](https://docs.forgegames.org/api-reference/users/create-a-user.md): Creates a new user within the specified team, associating the user with the team and enabling them to interact with its resources and systems. This endpoint can be used to add players, administrators, or other roles to a team, linking them with unique identifiers for tracking and management.
- [Delete a user](https://docs.forgegames.org/api-reference/users/delete-a-user.md)
- [List Users](https://docs.forgegames.org/api-reference/users/list-users.md): Lists all users belonging to the specified team. Users can own item instances or interact with spaces.
- [Build Your Game's Inventory System](https://docs.forgegames.org/build-inventory-systems.md): Learn how to set up a basic inventory system using Forge. You'll define items, create spaces to store them, and assign them to users.
- [Attributes](https://docs.forgegames.org/essentials/attributes.md): Define and manage item properties and statistics
- [Classifiers](https://docs.forgegames.org/essentials/classifiers.md): Group items based on characteristics and usage restrictions
- [Items](https://docs.forgegames.org/essentials/items.md): Items are the core components in Forge that drive the dynamics of your game world. Each item can be defined with specific attributes, classifiers, and optional visual representations. This document explains how to define an item, the role of classifiers, and how items interact with the game's mechan…
- [Spaces](https://docs.forgegames.org/essentials/spaces.md): Spaces in Forge serve as structured storage areas where item instances are stored and managed within your game. Each space defines a specific area designated for organizing items based on their usage or category. This document outlines how spaces function as storage compartments and their role in fa…
- [Inventory Systems](https://docs.forgegames.org/guides/inventory-systems.md): Organize and manage player items to enhance gameplay engagement and strategy
- [Access Control](https://docs.forgegames.org/integration/access-control.md): Securely authenticate API requests and protect your team's data
- [Item Instances](https://docs.forgegames.org/integration/item-instances.md): Create and manage individual occurrences of items with unique properties
- [Rolling](https://docs.forgegames.org/integration/rolling.md): Randomize item generation using roll numerators for scalable probabilities
- [User Management](https://docs.forgegames.org/integration/user-management.md): Link your game's users with Forge for persistence and state management
- [Introduction](https://docs.forgegames.org/introduction.md): Get started with Forge and learn how to build and integrate your game systems

## OpenAPI Specs

- [swagger](https://docs.forgegames.org/swagger.json)
- [openapi](https://docs.forgegames.org/api-reference/openapi.json)