Skip to main content

Status and Visibility

To manage the status and visibility of games and mods via the API we use the fields status and visible fields and want to draw additional attention to them as the values of these fields determines what data is returned. It is important to understand who is authorized to view what content on mod.io.

Visible attribute states & privileges

Only mods use the visible attribute allowing mod admins to control their availability. Public is the default value:

MeaningValueDescriptionModify AuthorizationFilter Authorization
Hidden0Resource is hidden and not returned when browsing.

If requested directly it will be returned provided the user is an admin or subscribed to the content. All resources are always returned via the /me endpoints.
Game & Mod AdminsGame & Mod Admins
Public1Resource is visible and returned via all endpoints.Game & Mod AdminsEveryone

Status attribute states & privileges

Games and mods use the status attribute allowing game admins to control their availability. For mods this is important because it allows game admins to control which mods are available without changing the visible value set by the mod admin. Not accepted is the default value until changed by a game admin, or if a file is added to a mods profile it will be moved to an accepted state provided the game developer does not have curation enabled.

MeaningValueDescriptionModify AuthorizationFilter Authorization
Not Accepted0Resource is not accepted and not returned when browsing.

Games will be returned if requested directly provided the user is an admin or the api_key used belongs to the game.

Mods will be returned if requested directly provided the user is an admin or subscribed to the content. All resources are always returned via the /me endpoints.
Game Admins OnlyGame Admins Only
Accepted1Resource is accepted and returned via all endpoints.Game Admins OnlyEveryone
Deleted3Resource is deleted and only returned via the /me endpoints.Game Admins OnlyGame Admins Only

Game team member privileges

As the member of a game team, you can modify your games status to show or hide it from API requests. When a game is not accepted you can still view it provided you are the games admin or using the games api_key. You can call the Get User Games endpoint to retrieve all games associated with the authenticated user regardless of the status of the game(s).

By default mods connected to a game will not be returned if they are hidden or not accepted. As the member of a game team, you can modify a mods status and visible fields and filter by these values (to view content normal users cannot see). We recommend you only change the status and let mod admins control the visible field.

info

Adjusting settings such as which curation option you wish to use for your game are only available via our official dashboard on the mod.io website.

Mod team member privileges

As a mod team member, you can modify the visible field to show or hide your mod from API requests. You cannot modify the status of your mod. When a mod is hidden you can still view it provided you are in the mod team or the authenticated user is subscribed to the mod. You can call the Get User Mods endpoint to retrieve all mods associated with the authenticated user regardless of their status and visible values.

Valid status & visibility filters

status=1
status-in=0,1
visible=1
visible-in=0,1

Game Admin Only status & visibility filters

status-not-in=1,2
status-gt=1
visible-not-in=1
visible-st=1

Important Note When Filtering

Due to the requirement of certain status & visible values only being available to administrators. We have restricted the amount of filters available for non-game admins and thus for both of these fields only direct matches = and -in are permitted. Attempting to use game team member filters without the required permissions will result in a 403 Forbidden error response.