API

{black.fa-lightbulb} API user tokens are only accessible from Formula.

Getting a User Token

You can create API tokens from your account page by clicking the switch icon between Twitch and Geometry Dash.

Abilities

View Allows the token to view all level requests created by or sent to the user.

Manage Allows the token to update the status of a request.

Report Allows the token to report a level request, issuing a strike to the user who created it. Requires the Manage ability.

Settings Allows the token to read and modify user settings (e.g., for Geode mods or other integrations).

Full Access Grants all current abilities, along with any that may be added in the future.

Endpoints

{warning.fa-lightbulb} From here on out the following properties must be passed in the header.
{
'Authorization': `Bearer ${token}`,
'Accept': 'application/json',
'Content-Type': 'application/json'
}

Creating Level Requests

`POST` `api/request/`

Body

Property Name	Expected Type	Description
`creator`	string	Creator name(s) of the level
`difficulty`	string	Difficulty of the level
`gd_id`	integer	Level id
`name`	string	Level name
`streamer_username`	string	Twitch username of the livestreamer
`type`	string	Classic or Platformer
`yt_video`	string	Youtube link

Getting Level Requests

`GET` `api/request/?status=`

Query parameters

Property Name	Expected Type	Description
`status`	pending / played / rejected / reported	Status the request is in

Getting a Level Request

`GET` `api/request/{id}`

Updating a Level Request

You can only update a request while in the pending status

`PUT` `api/request/{id}`