Gravity

Gravity provides recommended guilds, channels, messages, activities, and topics.

A dehydrated Gravity feed identifies feed items that can be hydrated separately.

Field	Type	Description
items	array[object]	The dehydrated feed items
load_id	string	The ID of the feed load

A hydrated Gravity feed contains resolved message and activity items.

Field	Type	Description
message_items	array[object]	The hydrated message items
activity_items	array[object]	The hydrated activity items

A Gravity message item reference identifies a message to hydrate.

Field	Type	Description
channel_id	snowflake	The ID of the message's channel
message_id	snowflake	The ID of the message

A Gravity guild list contains guilds recommended by Gravity.

Field	Type	Description
guilds	array[object]	The recommended guilds

Endpoints

GET/users/@me/gravity-icymi

Field	Type	Description
refresh?	boolean	Whether to force a refreshed feed

{
  "items": [],
  "load_id": "01J56PZ5RB9XQV3BWYMKJ7DQ94"
}

GET/gravity-recommended-guilds

POST/gravity-content

Hydrates Gravity message and activity item references. Returns a hydrated Gravity feed object on success.

Field	Type	Description
message_items	array[Gravity message item reference object]	The message references to hydrate
activity_items	array[object]	The activity item references to hydrate

{
  "message_items": [
    {
      "channel_id": "1204178985545056256",
      "message_id": "1262564215779856384"
    }
  ],
  "activity_items": []
}

POST/guilds/gravity-join

Joins the given Gravity guild recommendations.

Field	Type	Description
guild_ids	array[snowflake]	The IDs of the guilds to join
location	string	The client location initiating the guild join

{
  "guild_ids": ["1204178985545056256", "1215387377138409472"],
  "location": "icymi"
}

POST/gravity-topic-guilds

Returns a Gravity guild list object for the requested topic categories.

Field	Type	Description
category_ids	array[snowflake]	The IDs of the topic categories
offset	integer	The result offset

{
  "category_ids": ["1232035516401129472"],
  "offset": 0
}