Content Inventory

Content inventory records applications, games, music, and outbox entries associated with users.

Content Inventory Object

A content inventory contains entries and fetch state for a user's inventory.

Content Inventory Structure
FieldTypeDescription
wait_ms_until_next_fetch?integerThe number of milliseconds before the inventory may be fetched again
refresh_token?stringThe token that may be passed to a later request to refresh the inventory

The client consumes additional inventory entry collections from this object without imposing a fixed response schema.

Similar Games Object

A similar games object contains application IDs related to an application.

Similar Games Structure
FieldTypeDescription
similar_gamesarray[snowflake]The IDs of similar game applications
Example Similar Games
{
"similar_games": ["1107262924474323006", "1282012045544034304"]
}

Endpoints

Get My Content Inventory

GET/content-inventory/users/@me

Returns a content inventory object for the current user.

Query String Params
FieldTypeDescription
refresh_token?stringA token from an earlier response used to refresh the inventory
for_game_profile?booleanWhether to return inventory data for a game profile
feature?stringThe client feature requesting the inventory

Modify My Content Inventory Application

PATCH/content-inventory/users/@me/applications/{application.id}

Modifies sharing for the current user's content-inventory record for an application.

JSON Params
FieldTypeDescription
is_sharingbooleanWhether activity for the application is shared
Example JSON Params
{
"is_sharing": true
}

List Similar Games

GET/content-inventory/users/@me/similar-games/{application.id}

Returns a similar games object for the application.

Update Spotify Content Inventory

POST/content-inventory/users/@me/spotify

Updates the current user's Spotify content inventory.

JSON Params
FieldTypeDescription
connection_idsnowflakeThe ID of the Spotify connection
tracksarray[object]The listened tracks; the client submits one track without reshaping it