Introduction

How mods, servers and tools talk to ModKey, and what every answer looks like.

Every call is plain HTTPS, no SDK needed. Building a mod? Begin with the key check. Working from a server? Read authentication, then the API v2 overview.

Choose an interface

Basics

One URL per interface
API v2 is a single POST https://dev.mod.wtf/api/v2/action and the method field picks the action. Connect is POST https://dev.mod.wtf/{soft_id}/connect.
Two response shapes
API v2 answers {"ok": true, "data": …} or {"ok": false, "error": …}. Connect answers with a status boolean.
JSON or form
API v2 reads JSON and also parses form bodies. Connect takes application/x-www-form-urlencoded only.
Dates
Dates are Y-m-d H:i:s strings, for example 2026-06-01 12:00:00.
Paging
List actions take limit (1 to 200, default 50) and offset, and answer with total, limit, offset and items.
Durations are days
A negative duration means hours. lifetime means the key never expires.
Esc