curl --request POST \
--url https://forgegames.org/api/items/roll \
--header 'Authorization: Basic <encoded-value>'{
"item": {
"id": "<string>",
"name": "<string>",
"thumbnail": "<string>",
"rollNumerator": 123,
"createdAt": "<string>",
"updatedAt": "<string>",
"teamId": "<string>",
"classifiers": [
{
"id": "<string>",
"itemId": "<string>",
"classifierId": "<string>",
"classifierOptionId": "<string>",
"classifierOption": {
"id": "<string>",
"name": "<string>",
"dropRateMultiplier": 123,
"classifierId": "<string>"
}
}
]
},
"itemAttributeInstances": [
{
"itemAttributeId": "<string>",
"value": 123,
"attribute": {
"id": "<string>",
"name": "<string>",
"min": 123,
"max": 123,
"teamId": "<string>"
}
}
]
}Generates a randomized variation of an item. This endpoint is commonly used for loot drops or creating unique instances in games.
curl --request POST \
--url https://forgegames.org/api/items/roll \
--header 'Authorization: Basic <encoded-value>'{
"item": {
"id": "<string>",
"name": "<string>",
"thumbnail": "<string>",
"rollNumerator": 123,
"createdAt": "<string>",
"updatedAt": "<string>",
"teamId": "<string>",
"classifiers": [
{
"id": "<string>",
"itemId": "<string>",
"classifierId": "<string>",
"classifierOptionId": "<string>",
"classifierOption": {
"id": "<string>",
"name": "<string>",
"dropRateMultiplier": 123,
"classifierId": "<string>"
}
}
]
},
"itemAttributeInstances": [
{
"itemAttributeId": "<string>",
"value": 123,
"attribute": {
"id": "<string>",
"name": "<string>",
"min": 123,
"max": 123,
"teamId": "<string>"
}
}
]
}Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Successful response
Show child attributes
191191191191Show child attributes
191191191191Show child attributes
191191191Show child attributes
Show child attributes
191191191