Bulk operations · ModKey Docs

Reset keys HWID

POST https://dev.mod.wtf/api/v2/action

methodreset-keys-hwid

Reset devices for all matching keys.

Body

soft_id integer required

ID of a software you own
filter object optional

Object {game?, key_type?, active?, status?}

Errors it can return

not_found validation internal_error + shared codes

POST /api/v2/action HTTP/1.1
Host: dev.mod.wtf
Content-Type: application/json
Accept: application/json

{
    "api_key": "YOUR_API_KEY",
    "method": "reset-keys-hwid",
    "soft_id": 123,
    "filter": {
        "game": "standoff2"
    }
}

curl -sS -X POST 'https://dev.mod.wtf/api/v2/action' \
  -H 'Content-Type: application/json' \
  -d '{
    "api_key": "YOUR_API_KEY",
    "method": "reset-keys-hwid",
    "soft_id": 123,
    "filter": {
        "game": "standoff2"
    }
}'

const response = await fetch("https://dev.mod.wtf/api/v2/action", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
      "api_key": "YOUR_API_KEY",
      "method": "reset-keys-hwid",
      "soft_id": 123,
      "filter": {
          "game": "standoff2"
      }
  }),
});

const result = await response.json();

$ch = curl_init('https://dev.mod.wtf/api/v2/action');

curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode([
        'api_key' => 'YOUR_API_KEY',
        'method' => 'reset-keys-hwid',
        'soft_id' => 123,
        'filter' => [
            'game' => 'standoff2',
        ],
    ]),
]);

$result = json_decode(curl_exec($ch), true);

import requests

response = requests.post(
    "https://dev.mod.wtf/api/v2/action",
    json={
        "api_key": "YOUR_API_KEY",
        "method": "reset-keys-hwid",
        "soft_id": 123,
        "filter": {
            "game": "standoff2",
        },
    },
    timeout=10,
)

result = response.json()

{
    "ok": true,
    "data": {
        "affected": 42
    }
}

{
    "ok": false,
    "error": "not_found",
    "message": "soft not found or not yours"
}

{
    "ok": false,
    "error": "unauthorized",
    "message": "Invalid or missing api_key"
}

Pause keys

POST https://dev.mod.wtf/api/v2/action

methodpause-keys

Pause matching keys (active=0).

Body

soft_id integer required

ID of a software you own
filter object optional

The same filter object as reset-keys-hwid

Errors it can return

not_found validation database_error + shared codes

POST /api/v2/action HTTP/1.1
Host: dev.mod.wtf
Content-Type: application/json
Accept: application/json

{
    "api_key": "YOUR_API_KEY",
    "method": "pause-keys",
    "soft_id": 123,
    "filter": {
        "game": "standoff2"
    }
}

curl -sS -X POST 'https://dev.mod.wtf/api/v2/action' \
  -H 'Content-Type: application/json' \
  -d '{
    "api_key": "YOUR_API_KEY",
    "method": "pause-keys",
    "soft_id": 123,
    "filter": {
        "game": "standoff2"
    }
}'

const response = await fetch("https://dev.mod.wtf/api/v2/action", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
      "api_key": "YOUR_API_KEY",
      "method": "pause-keys",
      "soft_id": 123,
      "filter": {
          "game": "standoff2"
      }
  }),
});

const result = await response.json();

$ch = curl_init('https://dev.mod.wtf/api/v2/action');

curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode([
        'api_key' => 'YOUR_API_KEY',
        'method' => 'pause-keys',
        'soft_id' => 123,
        'filter' => [
            'game' => 'standoff2',
        ],
    ]),
]);

$result = json_decode(curl_exec($ch), true);

import requests

response = requests.post(
    "https://dev.mod.wtf/api/v2/action",
    json={
        "api_key": "YOUR_API_KEY",
        "method": "pause-keys",
        "soft_id": 123,
        "filter": {
            "game": "standoff2",
        },
    },
    timeout=10,
)

result = response.json()

{
    "ok": true,
    "data": {
        "affected": 42,
        "active": 0
    }
}

{
    "ok": false,
    "error": "not_found",
    "message": "soft not found or not yours"
}

{
    "ok": false,
    "error": "unauthorized",
    "message": "Invalid or missing api_key"
}

Resume keys

POST https://dev.mod.wtf/api/v2/action

methodresume-keys

Resume matching keys (active=1).

Body

soft_id integer required

ID of a software you own
filter object optional

Object {game?, key_type?, active?, status?}

Errors it can return

not_found validation database_error + shared codes

POST /api/v2/action HTTP/1.1
Host: dev.mod.wtf
Content-Type: application/json
Accept: application/json

{
    "api_key": "YOUR_API_KEY",
    "method": "resume-keys",
    "soft_id": 123,
    "filter": {
        "game": "standoff2"
    }
}

curl -sS -X POST 'https://dev.mod.wtf/api/v2/action' \
  -H 'Content-Type: application/json' \
  -d '{
    "api_key": "YOUR_API_KEY",
    "method": "resume-keys",
    "soft_id": 123,
    "filter": {
        "game": "standoff2"
    }
}'

const response = await fetch("https://dev.mod.wtf/api/v2/action", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
      "api_key": "YOUR_API_KEY",
      "method": "resume-keys",
      "soft_id": 123,
      "filter": {
          "game": "standoff2"
      }
  }),
});

const result = await response.json();

$ch = curl_init('https://dev.mod.wtf/api/v2/action');

curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode([
        'api_key' => 'YOUR_API_KEY',
        'method' => 'resume-keys',
        'soft_id' => 123,
        'filter' => [
            'game' => 'standoff2',
        ],
    ]),
]);

$result = json_decode(curl_exec($ch), true);

import requests

response = requests.post(
    "https://dev.mod.wtf/api/v2/action",
    json={
        "api_key": "YOUR_API_KEY",
        "method": "resume-keys",
        "soft_id": 123,
        "filter": {
            "game": "standoff2",
        },
    },
    timeout=10,
)

result = response.json()

{
    "ok": true,
    "data": {
        "affected": 42,
        "active": 1
    }
}

{
    "ok": false,
    "error": "not_found",
    "message": "soft not found or not yours"
}

{
    "ok": false,
    "error": "unauthorized",
    "message": "Invalid or missing api_key"
}

Extend keys

POST https://dev.mod.wtf/api/v2/action

methodextend-keys

Add or subtract days from activated, time-limited keys. Paused keys stay paused. Unactivated and lifetime keys are skipped.

Body

soft_id integer required

ID of a software you own
days integer required

-3650 to 3650, excluding zero
filter object optional

The same filter object as reset-keys-hwid

Errors it can return

not_found validation database_error + shared codes

POST /api/v2/action HTTP/1.1
Host: dev.mod.wtf
Content-Type: application/json
Accept: application/json

{
    "api_key": "YOUR_API_KEY",
    "method": "extend-keys",
    "soft_id": 123,
    "days": 7,
    "filter": {
        "game": "standoff2"
    }
}

curl -sS -X POST 'https://dev.mod.wtf/api/v2/action' \
  -H 'Content-Type: application/json' \
  -d '{
    "api_key": "YOUR_API_KEY",
    "method": "extend-keys",
    "soft_id": 123,
    "days": 7,
    "filter": {
        "game": "standoff2"
    }
}'

const response = await fetch("https://dev.mod.wtf/api/v2/action", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
      "api_key": "YOUR_API_KEY",
      "method": "extend-keys",
      "soft_id": 123,
      "days": 7,
      "filter": {
          "game": "standoff2"
      }
  }),
});

const result = await response.json();

$ch = curl_init('https://dev.mod.wtf/api/v2/action');

curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode([
        'api_key' => 'YOUR_API_KEY',
        'method' => 'extend-keys',
        'soft_id' => 123,
        'days' => 7,
        'filter' => [
            'game' => 'standoff2',
        ],
    ]),
]);

$result = json_decode(curl_exec($ch), true);

import requests

response = requests.post(
    "https://dev.mod.wtf/api/v2/action",
    json={
        "api_key": "YOUR_API_KEY",
        "method": "extend-keys",
        "soft_id": 123,
        "days": 7,
        "filter": {
            "game": "standoff2",
        },
    },
    timeout=10,
)

result = response.json()

{
    "ok": true,
    "data": {
        "days_applied": 7,
        "affected": 42
    }
}

{
    "ok": false,
    "error": "validation",
    "message": "days must be a non-zero integer between -3650 and 3650"
}

{
    "ok": false,
    "error": "unauthorized",
    "message": "Invalid or missing api_key"
}

Delete keys

POST https://dev.mod.wtf/api/v2/action

methoddelete-keys

Delete matching keys. kind=all requires confirm.

Body

soft_id integer required

ID of a software you own
kind string required

Expired, blocked, inactive, unused or all
confirm string optional

Required only for kind=all, value I_KNOW_WHAT_I_AM_DOING
filter object optional

Object {game?, key_type?, active?, status?}, applied on top of kind

Errors it can return

not_found confirmation_required validation delete_failed + shared codes

Deleting every key

kind=all removes every key of the software and needs confirm=I_KNOW_WHAT_I_AM_DOING. It cannot be undone.

POST /api/v2/action HTTP/1.1
Host: dev.mod.wtf
Content-Type: application/json
Accept: application/json

{
    "api_key": "YOUR_API_KEY",
    "method": "delete-keys",
    "soft_id": 123,
    "kind": "expired"
}

curl -sS -X POST 'https://dev.mod.wtf/api/v2/action' \
  -H 'Content-Type: application/json' \
  -d '{
    "api_key": "YOUR_API_KEY",
    "method": "delete-keys",
    "soft_id": 123,
    "kind": "expired"
}'

const response = await fetch("https://dev.mod.wtf/api/v2/action", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
      "api_key": "YOUR_API_KEY",
      "method": "delete-keys",
      "soft_id": 123,
      "kind": "expired"
  }),
});

const result = await response.json();

$ch = curl_init('https://dev.mod.wtf/api/v2/action');

curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode([
        'api_key' => 'YOUR_API_KEY',
        'method' => 'delete-keys',
        'soft_id' => 123,
        'kind' => 'expired',
    ]),
]);

$result = json_decode(curl_exec($ch), true);

import requests

response = requests.post(
    "https://dev.mod.wtf/api/v2/action",
    json={
        "api_key": "YOUR_API_KEY",
        "method": "delete-keys",
        "soft_id": 123,
        "kind": "expired",
    },
    timeout=10,
)

result = response.json()

{
    "ok": true,
    "data": {
        "deleted": 15,
        "kind": "expired"
    }
}

{
    "ok": false,
    "error": "confirmation_required",
    "message": "to delete ALL keys for this soft, pass confirm=I_KNOW_WHAT_I_AM_DOING"
}

{
    "ok": false,
    "error": "unauthorized",
    "message": "Invalid or missing api_key"
}

Block keys

POST https://dev.mod.wtf/api/v2/action

methodblock-keys

Block matching keys (status=0). Blocked keys are refused by Connect.

Body

soft_id integer required

ID of a software you own
filter object optional

Same structure as above

Errors it can return

database_error not_found validation + shared codes

POST /api/v2/action HTTP/1.1
Host: dev.mod.wtf
Content-Type: application/json
Accept: application/json

{
    "api_key": "YOUR_API_KEY",
    "method": "block-keys",
    "soft_id": 123,
    "filter": {
        "game": "standoff2"
    }
}

curl -sS -X POST 'https://dev.mod.wtf/api/v2/action' \
  -H 'Content-Type: application/json' \
  -d '{
    "api_key": "YOUR_API_KEY",
    "method": "block-keys",
    "soft_id": 123,
    "filter": {
        "game": "standoff2"
    }
}'

const response = await fetch("https://dev.mod.wtf/api/v2/action", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
      "api_key": "YOUR_API_KEY",
      "method": "block-keys",
      "soft_id": 123,
      "filter": {
          "game": "standoff2"
      }
  }),
});

const result = await response.json();

$ch = curl_init('https://dev.mod.wtf/api/v2/action');

curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode([
        'api_key' => 'YOUR_API_KEY',
        'method' => 'block-keys',
        'soft_id' => 123,
        'filter' => [
            'game' => 'standoff2',
        ],
    ]),
]);

$result = json_decode(curl_exec($ch), true);

import requests

response = requests.post(
    "https://dev.mod.wtf/api/v2/action",
    json={
        "api_key": "YOUR_API_KEY",
        "method": "block-keys",
        "soft_id": 123,
        "filter": {
            "game": "standoff2",
        },
    },
    timeout=10,
)

result = response.json()

{
    "ok": true,
    "data": {
        "affected": 42,
        "status": 0
    }
}

{
    "ok": false,
    "error": "not_found",
    "message": "soft not found or not yours"
}

{
    "ok": false,
    "error": "unauthorized",
    "message": "Invalid or missing api_key"
}

Unblock keys

POST https://dev.mod.wtf/api/v2/action

methodunblock-keys

Unblock matching keys (status=1).

Body

soft_id integer required

ID of a software you own
filter object optional

Same structure as above

Errors it can return

database_error not_found validation + shared codes

POST /api/v2/action HTTP/1.1
Host: dev.mod.wtf
Content-Type: application/json
Accept: application/json

{
    "api_key": "YOUR_API_KEY",
    "method": "unblock-keys",
    "soft_id": 123,
    "filter": {
        "game": "standoff2"
    }
}

curl -sS -X POST 'https://dev.mod.wtf/api/v2/action' \
  -H 'Content-Type: application/json' \
  -d '{
    "api_key": "YOUR_API_KEY",
    "method": "unblock-keys",
    "soft_id": 123,
    "filter": {
        "game": "standoff2"
    }
}'

const response = await fetch("https://dev.mod.wtf/api/v2/action", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
      "api_key": "YOUR_API_KEY",
      "method": "unblock-keys",
      "soft_id": 123,
      "filter": {
          "game": "standoff2"
      }
  }),
});

const result = await response.json();

$ch = curl_init('https://dev.mod.wtf/api/v2/action');

curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode([
        'api_key' => 'YOUR_API_KEY',
        'method' => 'unblock-keys',
        'soft_id' => 123,
        'filter' => [
            'game' => 'standoff2',
        ],
    ]),
]);

$result = json_decode(curl_exec($ch), true);

import requests

response = requests.post(
    "https://dev.mod.wtf/api/v2/action",
    json={
        "api_key": "YOUR_API_KEY",
        "method": "unblock-keys",
        "soft_id": 123,
        "filter": {
            "game": "standoff2",
        },
    },
    timeout=10,
)

result = response.json()

{
    "ok": true,
    "data": {
        "affected": 42,
        "status": 1
    }
}

{
    "ok": false,
    "error": "not_found",
    "message": "soft not found or not yours"
}

{
    "ok": false,
    "error": "unauthorized",
    "message": "Invalid or missing api_key"
}

#Keep in mind

#Reset keys HWID

Body

Errors it can return

#Pause keys

Body

Errors it can return

#Resume keys

Body

Errors it can return

#Extend keys

Body

Errors it can return

#Delete keys

Body

Errors it can return

#Block keys

Body

Errors it can return

#Unblock keys

Body

Errors it can return

Keep in mind

Reset keys HWID

Pause keys

Resume keys

Extend keys

Delete keys

Block keys

Unblock keys