Skip to main content
POST
/
items
/
roll
Roll an item
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>"
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Response

Successful response

​
item
object
required
​
itemAttributeInstances
object[]
required