Skip to content

Create user status type

Request

Create user status type as admin

Security
authJWT
Bodyapplication/jsonrequired
namestringrequired

User Status Type name

descriptionstring

User Status Type description

minTokenBalancestringrequired

User Status Type eligible Token Addresses

discountPercentagenumberrequired

User Status Type discount Rate in percentage

imageUrlstring

User Status Type image Url

eligibleTokenAddressesArray of strings

Eligible token contract addresses for this status type

Example:
[ "0x1234...", "0x5678..." ]
tagsArray of strings

Tags for categorization and filtering

Example:
[ "vip", "premium", "gold" ]
ordernumber

Explicit ordering for status hierarchy (higher = more prestigious). If not set, falls back to minTokenBalance for ordering.

Example:100
curl -i -X POST \
  https://docs.pers.ninja/_mock/swagger/users/status-types \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "description": "string",
    "minTokenBalance": "string",
    "discountPercentage": 0,
    "imageUrl": "string",
    "eligibleTokenAddresses": [
      "0x1234...",
      "0x5678..."
    ],
    "tags": [
      "vip",
      "premium",
      "gold"
    ],
    "order": 100
  }'

Responses

User status type created

Bodyapplication/json
namestringrequired

User Status Type name

descriptionstring

User Status Type description

minTokenBalancestringrequired

User Status Type eligible Token Addresses

discountPercentagenumberrequired

User Status Type discount Rate in percentage

imageUrlstring

User Status Type image Url

eligibleTokenAddressesArray of strings

Eligible token contract addresses for this status type

Example:
[ "0x1234...", "0x5678..." ]
tagsArray of strings

Tags for categorization and filtering

Example:
[ "vip", "premium", "gold" ]
ordernumber

Explicit ordering for status hierarchy (higher = more prestigious). If not set, falls back to minTokenBalance for ordering.

Example:100
idnumberrequired

User Status Type id

Response
{ "name": "string", "description": "string", "minTokenBalance": "string", "discountPercentage": 0, "imageUrl": "string", "eligibleTokenAddresses": [ "0x1234...", "0x5678..." ], "tags": [ "vip", "premium", "gold" ], "order": 100, "id": 0 }