Title-Wide Data Management - Update Random Result Tables

NOTE: This is a Legacy Economy API, and is in bugfix-only mode. All new Economy features are being developed only for version 2. Updates the random drop table configuration for the title

POST https://titleId.playfabapi.com/Admin/UpdateRandomResultTables

Request Header

Name Required Type Description
X-SecretKey True

string

This API requires a title secret key, available to title admins, from PlayFab Game Manager.

Request Body

Name Type Description
CatalogVersion

string

which catalog is being updated. If null, update the current default catalog version

CustomTags

object

The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).

Tables

RandomResultTable[]

array of random result tables to make available (Note: specifying an existing TableId will result in overwriting that table, while any others will be added to the available set)

Responses

Name Type Description
200 OK

UpdateRandomResultTablesResult

400 Bad Request

ApiErrorWrapper

This is the outer wrapper for all responses with errors

Security

X-SecretKey

This API requires a title secret key, available to title admins, from PlayFab Game Manager.

Type: apiKey
In: header

Definitions

Name Description
ApiErrorWrapper

The basic wrapper around every failed API response

RandomResultTable
ResultTableNode
ResultTableNodeType
UpdateRandomResultTablesRequest

This operation is additive. Tables with TableId values not currently defined will be added, while those with TableId values matching Tables currently in the catalog will be overwritten with the given values.

UpdateRandomResultTablesResult

ApiErrorWrapper

The basic wrapper around every failed API response

Name Type Description
code

integer

Numerical HTTP code

error

string

Playfab error code

errorCode

integer

Numerical PlayFab error code

errorDetails

object

Detailed description of individual issues with the request object

errorMessage

string

Description for the PlayFab errorCode

status

string

String HTTP code

RandomResultTable

Name Type Description
Nodes

ResultTableNode[]

Child nodes that indicate what kind of drop table item this actually is.

TableId

string

Unique name for this drop table

ResultTableNode

Name Type Description
ResultItem

string

Either an ItemId, or the TableId of another random result table

ResultItemType

ResultTableNodeType

Whether this entry in the table is an item or a link to another table

Weight

number

How likely this is to be rolled - larger numbers add more weight

ResultTableNodeType

Name Type Description
ItemId

string

TableId

string

UpdateRandomResultTablesRequest

This operation is additive. Tables with TableId values not currently defined will be added, while those with TableId values matching Tables currently in the catalog will be overwritten with the given values.

Name Type Description
CatalogVersion

string

which catalog is being updated. If null, update the current default catalog version

CustomTags

object

The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).

Tables

RandomResultTable[]

array of random result tables to make available (Note: specifying an existing TableId will result in overwriting that table, while any others will be added to the available set)

UpdateRandomResultTablesResult

Error Codes

Name Code
InvalidDropTable 1201
InvalidJSONContent 1200